2015 年 ， 移 动 互联 网 革命 已 经 到 了 白热化 的 阶段 ， 一 个 充满 机 遇 的 巨大 市 场 已 经 开启 ， 全 球 无 数 的 行业 精英 都 已 投身 其 中 ， 书 写 出 不 少 令 人 瞩目 的 传奇 事迹 ;对 于 我 们 普通 的 开发 者 来 说 ， 则 更 需要 做 
好 准备 ， 迎 接 随时 可 能 到 来 的 机 遇 和 挑战 。Android 和 PHP， 作 为 目前 移动 互联 网 领域 中 最 热门 的 两 门 技术 ， 早 已 受到 广大 开发 者 们 的 关注 。 


本 书 是 目前 市 面 上 唯一 一 本 同时 讲述 Android 客 户 端 开发 和 PHP 服 务 端 开 发 两 方面 内 容 ， 并 且 能 把 Android 和 PHP 技 术 相 结合 的 移动 应 用 开发 方案 分 析 透 彻 的 书籍 。 通 过 本 书 ， 你 不 仅 可 以 学 习 到 
Android 客 户 端 开发 技巧 ， 同 时 还 可 以 掌握 PHP 服 务 端 开 发 的 精华 ， 甚 至 还 可 以 开拓 你 进行 软件 架构 的 思路 。 选 择 了 本 书 ， 你 就 真正 找到 了 一 条 能 够 精通 “Android 客 户 端 和 PHP 服 务 端 开发 ”的 捷径 ! 


本 书 的 写作 风格 大 众 化 ， 注 重 实用 性 ， 章 节 精 心 编排 ， 讲 解 由 浅 入 深 ， 力 求 让 读者 能 够 在 最 快 的 时 间 内 上 手 ， 同 时 也 可 以 拓宽 读者 在 移动 互联 网 应 用 开发 方面 的 思路 。 特 别 要 指出 的 是 ， 本 书 的 代码 实 
例 都 源 自 真实 的 项 目 ， 实 用 价值 极 高 。 此 外 ， 书 中 很 多 内 容 都 融合 了 笔者 多 年 来 在 互联 网 软件 架构 方面 的 经 验 。 总 而 言 之 ， 本 书 绝对 是 一 本 不 可 多 得 的 经 典 之 作 ! 


如 何 使 用 本 书 


在 开始 阅读 本 书 之 前 ， 请 您 先 阅读 以 下 内 容 ， 以 确保 能 最 快 地 了 解 本 书 的 思路 和 结构 ， 并 快速 地 找到 最 适合 自己 的 阅读 方式 。 考 虑 到 实用 性 ， 也 为 了 让 思路 更 清晰 ， 本 书 独创 性 地 采用 了 “项 目 跟 进 
式 ” 的 结构 ， 以 具有 代表 性 的 “ 微 博 应 用 ”实例 项 目 为 主线 ， 贯 穿 始终 。 全 书 内 容 分 为 四 大 部 分 : 准备 篇 、 实 战 篇 、 优 化 篇 、 进 阶 篇 ， 简 介 如 下 。 


“ 准备 篇 : 本 篇 主要 介绍 Android 和 PHP 开 发 中 需要 用 到 的 基础 概念 与 用 法 ， 为 后 面 的 “实战 篇 ”做 准备 。 不 管 做 什么 事情 ， 打 好 基础 是 至 关 重 要 的 ， 所 以 笔者 建议 大 家 好 好 阅读 本 篇 内 容 。 


+ 实战 篇 : 在 本 篇 中 ， 我 们 将 带领 您 逐步 完成 一 个 完整 的 “ 微 博 应 用 ”项 目 ， 从 前 期 的 产品 设计 、 架 构 设计 ， 到 服务 端 和 客户 端的 编码 ， 直 至 最 后 的 大 功 告 成 ， 整 个 过 程 一 气 呵 成 ， 让 读者 感觉 仿佛 亲 
身 参 与 到 这 个 项 目 中 ， 以 达到 最 好 的 学 习 效 果 。 


“ 优化 篇 : 系统 优化 已 经 成 为 当代 软件 开发 过 程 中 至 关 重 要 的 一 个 环节 。 在 本 篇 中 ， 读 者 将 学 到 一 些 从 实际 项 目 中 总 结 出 的 非常 实用 的 优化 经 验 和 技巧 ; 如 果 您 想 更 深入 地 学 习 使 用 Android 平 台 和 PHP 
语言 ， 绝 不 能 错过 本 篇 。 


: 进 阶 篇 : 本 篇 包含 一 些 Android 开 发 中 的 进 阶 内容 ， 主 要 包括 Android NDK 和 Android 游 戏 开发 相关 的 入 门 知识 。 此 外 ， 本 篇 内 容 还 涉及 OpenGL、RenderSctipt 相 关 的 高 级 用 法 ， 以 及 包括 Cocos2d-x 和 
Unity 3D 在 内 的 主流 游戏 引擎 的 相关 知识 ， 适 合 希 望 进一步 学 习 的 读者 阅读 。 


本 书 共 13 章 ， 每 章 的 主要 内 容 见 下 面 的 “章节 简介 ”， 方 便 读者 快速 查找 感 兴趣 的 部 分 。 


第 1 章 学 前 必 读 


本 章 的 主要 目的 是 让 读者 对 移动 互联 网 应 用 开发 有 一 个 比较 清晰 的 认识 ， 同 时 讲 清 楚 选 择 Android 加 PHP 这 套 解 决 方案 的 原因 ， 并 向 读者 介绍 在 学 习 过 程 中 所 要 使 用 的 正确 的 学 习 方 法 和 思路 。 


第 2 章 Android 开 发 准备 


本 章 内 容 包 含 了 对 Android 系 统 框架 、Android 应 用 程序 框架 、Android 图 形 界面 系统 以 及 Android 常 见 开发 思路 的 介绍 。 另 外 ， 通 过 本 章 的 学 习 ， 读 者 还 将 学 会 如 何 安 装 和 使 用 Android 的 开发 环境 和 
必 备 工具 (Eclipse 和 ADT) ， 并 学 会 创建 自己 的 第 一 个 Android 项 目 (Hello World 项 目 ) ， 由 此 开始 您 的 Android 开 发 之 旅 。 


第 3 章 ”PHP 开发 准备 


通过 本 章 的 学 习 ， 您 将 快速 地 学 会 如 何 使 用 PHP 进 行 服务 端 开 发 ， 如 果 您 已 经 有 一 定 的 服务 端 开 发 基础 ， 学 习 起 来 会 更 加 轻松 。 当 然 ， 本 章 也 包括 PHP 开 发 环境 (Xampp) 的 架设 和 一 些 其 他 配套 服务 
端 组 件 (Apache 和 MySQL) 的 基础 管理 。 最 后 ， 本 章 还 重点 介绍 了 一 个 基于 Zend Framework 和 Smarty 的 PHP 开 发 框架 : Hush Framework， 本 书 实例 的 服务 端正 是 采用 这 个 框架 进行 开发 的 。 


第 4 章 ”实例 产品 设计 


从 这 一 章 开 始 ， 我 们 将 动手 完成 一 个 完整 的 移动 互联 网 项 目 ， 即 “ 微 博 应 用 ”实例 的 项 目 。 本 章 所 讲 的 主要 是 项 目的 前 期 工作 ， 包 括 功能 模块 设计 以 及 一 些 项 目 策划 的 内 容 。 当 然 ， 如 果 您 是 项 目 管理 
人 员 ， 可 能 会 比 开发 者 们 对 本 章 更 感 兴趣 ， 里 面 所 涉及 的 一 些 设计 方法 和 思路 ， 均 是 很 实用 的 经 验 。 


第 5 章 “程序 架构 设计 


本 章 应 该 算是 本 书 的 核心 章节 之 一 ， 这 里 我 们 将 对 “ 微 博 应 用 ”项 目 实例 的 服务 端 以 及 客户 端的 整体 代码 框架 进行 深入 的 剖析 。 由 于 架构 设计 是 整个 项 目的 基础 ， 所 以 如 果 您 要 继续 往 下 学 习 ， 就 必须 
把 这 里 的 思路 都 理 清楚 。 如 果 您 善于 思考 ， 应 该 能 从 本 章 学 习 到 不 少 Android 和 PHP 应 用 架构 的 精 蚤 。 


第 6 章 服务 端 开 发 


本 章 也 是 本 书 的 重点 章节 之 一 ， 这 里 我 们 将 在 第 5 章 的 服务 端 架 构 基础 上 展开 ， 分 析 和 讲解 实例 服务 端的 代码 逻辑 和 写法 ， 带 领 您 进一步 深入 认识 PHP 服 务 端 开发 的 方法 。 读 者 可 以 将 本 章 的 部 分 章节 内 
容 和 第 7 章 的 部 分 章节 内 容 进行 对 照 阅 读 ， 这 样 对 理解 移动 互联 网 应 用 的 开发 思路 会 很 有 帮助 。 


第 7 章 客户 端 开 发 


本 章 也 是 本 书 的 重点 章节 之 一 ， 在 本 章 中 你 可 以 逐步 学 习 Android 应 用 开发 的 实用 技巧 ， 以 及 如 何在 客户 端 与 服务 器 之 间 进 行 通信 (包括 图 片 的 上 传 和 展示 ) 。 通 过 对 本 章 的 学 习 ， 读 者 不 仅 能 学 会 如 
何 正确 地 使 用 这 些 开 发 技巧 ， 更 重要 的 是 还 能 掌握 如 何 把 这 些 技巧 运用 到 实际 项 目 中 去 ， 这 是 完全 不 同 的 两 个 境界 ， 也 正 是 本 书 最 宝贵 、 最 特别 的 地 方 ， 希 望 大 家 能 好 好 阅读 和 体会 。 


第 8 章 “性 能 分 析 


有 过 项 目 实战 经 验 的 朋友 应 该 都 知道 ， 其 实在 编码 阶段 完成 之 后 ， 项 目 最 多 也 才 进行 了 一 半 ， 后 面 还 有 很 多 的 事情 需要 我 们 来 做 ， 而 性 能 测试 和 优化 就 是 其 中 非常 重要 的 一 个 环节 ， 本 章 我 们 将 对 性 能 
分 析 的 相关 内 容 进行 详细 介绍 。 另 外 ， 在 本 章 中 ， 读 者 也 可 以 学 到 一 些 非常 实用 的 优化 思路 和 经 验 。 


第 9 章 服务 端 优化 


根据 第 8 章 中 总 结 的 优化 思路 ， 本 章 将 教会 读者 如 何 对 PHP 服 务 端的 各 个 组 成 部 分 实施 优化 策略 ,着重 介绍 了 PHP 代 码 优 化 、JSON 协 议 优化 ， 以 及 HTTP 服 务 器 和 MySQL 数 据 库 优化 相关 的 内 容 ， 相 信 
这 些 经 验 在 深入 学 习 PHP 服 务 端 开发 的 过 程 中 会 起 到 非常 大 的 作用 。 


第 10 章 客户 端 优化 


在 本 章 中 ， 您 将 学 到 许多 有 用 的 Android 开 发 中 的 优化 思路 和 方法 。 本 章 重点 介绍 了 Android 程 序 优化 、Android UI 优化 、 图 片 优 化 ， 以 及 与 避免 内 存 泄露 相关 的 内 容 ， 这 些 经 验 对 能 否 写 出 一 个 高 质 


量 的 Android 应 用 来 说 是 非常 重要 的 。 


第 11 章 “Android 特 色 功 能 开发 


本 章 主要 介绍 一 些 与 Android 系 统 提供 的 特色 功能 开发 相关 的 知识 ， 比 如 Google Map API 的 使 用 、LBS 相 关 功 能 、 传 感 器 的 使 用 、 摄 像 头 的 使 用 ， 以 及 语音 识别 功能 等 。 相 信 掌 握 了 这 些 知识 后 ， 我 们 
可 以 开发 出 许多 别 具 特 色 的 Android 应 用 。 


第 12 章 Android NDK 开 发 


本 章 介绍 了 与 Android NDK 开 发 相关 的 基础 知识 ， 并 创建 首 个 NDK 项 目 。 如 果 您 需要 使 用 C 或 C++ 语言 来 开发 Android 程 序 ， 或 者 想 把 一 些 基于 5 或 C++ 的 程序 或 者 类 库 移 植 到 Android 平 台 下 ， 那 么 
肯定 会 对 本 章 内 容 比 较 感 兴趣 。 


第 13 章 Android 游 戏 开发 


本 章 介绍 了 与 Android 游 戏 开发 相关 的 基础 知识 ,包含 了 OpenGL 和 RenderScript 的 基础 用 法 ,以 及 Cocos2d-x 和 Unity 3D 游 戏 引擎 的 相关 内 容 。 游 戏 开 发 和 应 用 开发 的 思路 还 是 有 很 大 区 别 的 ， 如 果 
您 对 Android 游 戏 开发 比较 感 兴趣 ， 请 关注 本 章 内 容 ， 相 信 本 章 知识 对 Android 游 戏 开发 的 学 习 也 会 有 所 帮助 。 


由 于 时 间 有 限 ， 书 中 难免 存 有 朴 漏 ， 诚 恳 希望 各 位 读者 批评 、 指 正 。 当 然 ， 如 果 您 在 阅读 过 程 中 发 现 了 问题 ， 或 者 遇 到 疑问 ， 欢 迎 加 入 本 书 QQ 群 (122860896) ， 与 大 家 一 起 交流 ， 或 者 发 邮件 给 
我 ， 我 的 邮箱 是 : huangjuanshi@163.com， 真 切 希 望 和 大 家 共同 进步 。 


源码 简介 


请 读者 登录 华章 网 站 (www.hzbook.com) 的 本 书页 面 下 载 本 书 所 有 源码 。 高 质量 的 应 用 实例 是 本 书 的 一 大 特色 ， 所 有 的 实例 代码 都 按照 实际 项 目的 规范 来 书写 ， 且 都 经 过 严格 的 审核 ， 保 证 运行 无 
误 。 另 外 ， 本 书 实例 源码 的 获取 也 采用 了 最 接近 实际 项 目 开 发 的 形式 ， 有 经 验 的 读者 甚至 可 以 直接 通过 SVN 工 具 从 Google Code 项 目 SVN 源 中 获取 。 本 书 主 要 实例 源码 有 以 下 几 个 。 


1.Hush Framework 实 例 源码 


Hush Framework 是 本 书 重点 介绍 的 PHP 开 源 开发 框架 ， 该 框架 的 核心 类 库 和 实例 源码 都 可 以 从 GitHub 上 的 项 目 主 页 直接 下 载 ， 地 址 是 https://github.com/jameschz/hush。 与 Hush Framework 实 
例 部 署 有 关 的 内 容 请 参见 本 书 附录 A。 


2. 微 博 实例 源码 


微 博 实例 源码 中 包含 了 两 个 项 目 ， 即 服务 端 PHP 项 目 (app-demos-server) ， 以 及 客户 端 Android 项 目 (app-demos-client) ， 其 源码 包 “android-php-source.zip” 也 可 以 从 GitHub 上 的 本 书 官方 
网 站 下 载 ， 地 址 是 https://github.com/jameschz/androidphp。 与 微 博 实例 部 署 有 关 的 信息 请 参考 本 书 附 录 B。 


3 特色 功能 源码 


该 实例 项 目 包含 了 第 11 章 中 涉及 的 所 有 实例 的 源码 ， 包 含 了 Google Map APlI 使 用 、 传 感 器 使 用 以 及 摄像 头 使 用 等 实例 ， 源 码 包含 在 微 博 实例 源码 中 ， 详 见 android-php-source/androidphp/special 
目录 。 


4.0penGL 实 例 源码 


该 实例 项 目 包含 了 第 13 章 中 涉及 的 与 OpenGL 使 用 有 关 的 实例 源码 ， 其 中 包括 了 与 2D 和 3D 泻 染 有 关 的 两 个 实例 ,源码 包含 在 微 博 实例 源码 中 ， 详 见 android-php-source/androidphp/opengl 目 录 。 


外 ， 以 上 所 有 实例 项 目的 源码 都 可 以 通过 Eclipse 的 Import 工 具 ( 即 File 菜 单 中 的 Import 选 项 ) 导入 Eclipse 开 发 工具 中 进行 阅读 。 成 功 导入 之 后 的 项 目 代 码 树 如 下 图 所 示 。 


= ky app-demos-client [trunk/ app/demos/ client] 


由 -四 sre 


由 23 gen [Generated Java 
HMA Android 2.2 
ea assets 
由 ley doc 
由 ay res 
c AndroidManifest. xml 


Files] 


97 12-5-14 F49:00 shagoo 


: E! default. properties 46 11-12-27 TF F3:41 shagoo 
|W) proguard. cfg 46 11-12-27 F 3:41 shagoo 

由 it app-demos-opengl [trunk/ app/demos/ opengl] 

- i app-demos-server [trunk/app/demos/ server] 


由 ley bin 


由 c3 app-demos-special [trunk/app/demos/special] 


此 外 ， 还 有 一 些 实例 源码 属于 第 三 方 的 开发 包 (SDK) ， 比 如 Android NDK 中 的 hello-jni 项 目 、Cocos2d-x 开 发 包 中 的 Hello World 项 目 等 。 


致谢 


首先 ， 感 谢 华章 公司 的 编辑 们 ， 没 有 你 们 的 建议 和 帮助 ， 绝 对 无 法 制作 出 如 此 经 典 的 技术 书籍 ; 其 次 ， 感 谢 我 的 妻子 和 刚 出 世 的 宝宝 ， 你 们 为 我 的 创作 提供 了 无 穷 的 动力 ;再 次 ， 还 要 感谢 我 的 父母 和 


亲友 ， 你 们 的 支持 和 鼓励 让 我 更 有 信心 ; 最 后 ， 我 必须 向 Android 和 PHP 技 术 的 创造 者 们 致敬 ， 你 们 旬 


第 一 篇 


第 1 章 学 前 必 读 


造 出 了 如 此 优秀 的 产品 ， 为 我 们 开启 了 移动 互联 网 的 精彩 世界 。 


准备 篇 


在 学 习 任何 知识 之 前 ， 做 好 准备 工作 是 非常 有 必要 的 。 在 本 章 ， 我 们 先 来 了 解 一 下 目前 正如 火 如 茶 的 移动 互联 网 时 代 的 大 背景 ， 然 后 我 们 会 讲 清楚 我 们 为 何 要 学 习 Android 和 PHP 这 套 组 合 方案 ， 以 及 
学 习 Android 和 PHP 开 发 的 大 体 思路 和 学 习 方 法 。 相 信 大 家 读 完 本 章 以 后 ， 不 仅 会 对 Android 和 PHP 这 个 强大 的 组 合 更 感 兴趣 ， 而 且 之 后 的 学 习 之 路 会 更 加 顺畅 。 


第 一 篇 


准备 篇 


第 1 章 学 前 必 读 


在 学 习 任何 知识 之 前 ， 做 好 准备 工作 是 非常 有 必要 的 。 在 本 章 ， 我 们 先 来 了 解 一 下 目前 正如 火 如 茶 的 移动 互联 网 时 代 的 大 背景 ， 然 后 我 们 会 讲 清楚 我 们 为 何 要 学 习 Android 和 PHP 这 套 组 合 方案 ， 以 及 
学 习 Android 和 PHP 开 发 的 大 体 思路 和 学 习 方 法 。 相 信 大 家 读 完 本 章 以 后 ， 不 仅 会 对 Android 和 PHP 这 个 强大 的 组 合 更 感 兴趣 ， 而 且 之 后 的 学 习 之 路 会 更 加 顺畅 。 


1.1 “移动 互联 网 时 代 的 来 临 


早 在 2011 年 ，Android 操 作 系统 就 已 经 占领 了 全 球 智能 手机 市 场 份额 的 半壁 江山 ， 到 了 2014 年 ， 更 是 占领 了 全 球 80% 以 上 的 市 场 份额 (如 图 1-1 所 示 ) ， 其 霸主 地 位 彰显 无 遗 。 在 中 国 ， 随 着 各 大 手机 
厂商 的 更 新 换代 ， 在 Android 操 作 系统 基础 上 深度 定制 出 来 的 优秀 手机 产品 也 是 层出不穷 ， 小 米 、 联 想 、 华 为 等 都 是 其 中 的 佼佼 者 ; 近年 来 4G 手 机 的 普及 更 是 大 大 推动 了 移动 互联 网 市 场 “全民 化 ”的 进 
程 。 持 续 增长 的 用 户 基数 ， 高 速 膨 胀 的 市 场 规模 ， 让 所 有 人 都 聚焦 到 这 个 令 人 兴奋 的 领域 之 中 。 


全 球 智能 手机 市 场 份额 
( 2014Q2 ) Windows Phohe 


2.70% 


11.90% 0.60% 


图 1-1 2014 年 全 球 智 能 手机 市 场 份额 (摘自 dazeinfo.com) 


看 到 这 里 ， 相 信 敏 感 的 读者 已 经 能 够 感受 到 这 个 巨大 市 场 里 面 的 无 限 潜力 ， 我 们 来 试 着 分 析 一 下 。 首 先 ， 以 目前 移动 互联 网 发 展 的 迅猛 势头 ， 在 可 以 预见 的 不 久 将 来 ， 全 球 移动 终端 将 全 面 升级 到 智能 
系统 ， 而 以 Android 操 作 系 统 在 其 中 占 的 比例 来 看 ， 必 将 会 瓜分 到 这 块 “ 大 蛋糕 ”的 很 大 一 部 分 。 其 次 ， 随 着 移动 互联 网 市 场 的 不 断 膨胀 ， 对 移动 终端 开发 人 员 的 需求 量 将 会 飞速 增加 ， 对 于 我 们 开发 者 来 
说 ,这 是 个 绝 好 的 提升 自己 的 机 会 试问， 我 们 怎 能 放 过 ? 不 要 犹 隐 了 ， 让 我 们 一 起 加 入 到 Android 平 台 应 用 开发 的 大 潮 里 来 吧 ! 


1.2 ”为何 选择 Android 和 PHP 


我 们 为 何 要 选择 Android 和 PHP 这 套 解 决 方案 呢 ? 原 因 已 经 不 言 而 喻 。 时 至 今日 ，Android 和 PHP 已 经 发 展 成 为 移动 领域 和 互联 网 领域 最 领先 的 技术 方案 之 一 。 我 们 还 关注 到 一 个 很 有 意思 的 数据 ， 那 就 
是 这 两 种 技术 的 市 场 占有 率 。 前 面 我 们 已 经 提 到 过 Android 系 统 的 全 球 占有 率 ， 然 而 ， 目 前 PHP 语 言 在 互联 网 领域 的 使 用 率 甚 至 比 Android 系 统 更 高 ， 所 以 ，Android 系 统 加 上 PHP 语 言 如 此 强大 的 组 合 ， 我 
们 又 怎 能 忽视 呢 ? 接 下 来 ， 让 我 们 分 析 一 下 Android 系 统 和 PHP 语 言 各 自 的 优势 所 在 。 


1.2.1 Android 平 台 的 优势 


: 开放 性 : 毫 无 疑 间 ，Android 平 台 的 开放 性 就 是 它 在 短 时 间 内 能 占领 市 场 的 最 强 武 器 之 一 。Google 希 望 通过 Android 平 台 打 通 运营 商 、 设 备 制造 商 、 开 发 商 以 及 其 他 各 个 层面 ， 建 立 起 标准 化 、 开 放 式 的 
移动 平台 生态 系统 。 

“ 完备 性 : 对 于 开发 商 或 者 开发 者 来 说 ， 系 统 平台 的 完备 性 无 疑 是 他 决定 是 否 加 入 这 个 阵营 最 重要 的 因素 之 一 。 而 Android 系 统 无 疑 是 目前 功能 最 为 强大 ， 设 计 最 为 精良 的 移动 操作 系统 之 一 ， 而 且 背 后 
还 有 Google 公 司 的 强大 实力 作为 支持 ， 这 也 大 大 减少 了 项 目 开发 的 后 顾 之 忧 。 


创造 性 : 由 于 Android 系 统 是 开源 的 ， 允 许 第 三 方 修改 。 对 于 开发 商 来 说 ， 在 这 个 平台 之 上 ， 可 以 把 自己 的 创造 力 发 挥 到 最 大 ; 而 对 于 设备 制造 商 来 说 ， 根 据 自己 的 硬件 进行 调 优 ， 从 而 能 够 更 好 地 适 
应 硬件 ， 与 之 形成 良好 的 结合 。 


1.2.2 PHP 语言 的 优势 


“ 稳定 性 : 毫 无 疑问 ，PHP 已 经 是 目前 互联 网 服务 端 使 用 最 广泛 的 编程 语言 之 一 ， 目 前 PHP 在 互联 网 应 用 领域 的 占有 牵 位 居 全 球 第 一 。 试 问 ， 如 果 本 身 不 够 成 熟 和 稳定 ， 如 何 能 占有 如 此 大 的 市 场 呢 ? 


ARE: 简单 实用 ， 学 习 成 本 低 ， 这 也 是 很 多 开发 者 愿意 选择 PHP 的 最 重要 原因 ， 特 别 是 对 于 互联 网 项 目 来 说 ， 需 求 变 动 是 非常 大 的 ， 因 此 ， 如 果 选 择 PHP， 就 可 以 节省 出 更 多 时 间 和 精力 去 做 其 他 


: 开放 性 : PHP 本 身 是 开源 的 ， 允 许 开发 者 对 其 进行 扩展 和 优化 ， 其 整套 服务 端 部 署 解 决 方案 也 是 免费 的 ， 因 此 ， 使 用 这 套 解决 方案 能 大 大 地 降低 成 本 ， 对 于 大 部 分 资金 紧张 的 互联 网 企业 来 说 ， 何 乐 
而 不 为 呢 ? 


完备 性 : LAMP (Linux+Apache+MySQL+PHP) 这 个 绝 佳 组 合 早已 闻名 业界 ， 而 现在 Nginx+PHP FastCGI 的 出 现 使 其 HTTP 服 务 端的 性 能 更 上 一 层 楼 。 对 于 目前 绝 大 部 分 互联 网 应 用 来 说 ， 这 和 套 解决 方 
案 都 可 以 很 好 地 满足 它们 的 需求 。 


事实 上 ， 目 前 已 经 有 很 多 成 功 的 移动 互联 网 应 用 软件 和 游戏 正在 使 用 Android 加 PHP 的 架构 ， 其 中 就 包括 风头 正 劲 的 “新 浪 微 博 ” 和 “腾讯 微 博 ”。 这 些 成 功 的 例子 很 好 地 验证 了 Android 加 PHP 这 个 组 
合 的 强大 。 当 然 ， 我 们 的 开发 团队 在 许多 的 实际 项 目 中 也 都 使 用 这 套 架 构 来 进行 开发 。Android 加 PHP 所 展现 出 的 灵活 度 和 扩展 性 也 确实 让 我 们 相当 满意 。 


总 而 言 之 ，Android 的 创造 性 加 上 PHP 的 灵活 性 确实 是 “天 造 之 和 ”， 也 可 以 满足 绝 大 部 分 的 移动 互联 网 应 用 快速 变化 的 需求 。 当 然 ， 如 果 我 们 希望 在 服务 端 采用 其 他 的 技术 ， 例 如 Java、Python 或 者 
Ruby On Rails， 这 也 是 没有 问题 的 。 因 为 我 们 的 服务 端 用 于 和 客户 端 打交道 的 实际 上 是 JSON 协 议 ， 而 JSON 是 一 种 跨 语言 的 协议 ， 我 们 在 服务 端 可 以 用 任意 语言 来 组 合 JSON 数 据 并 供给 Android 客 户 端 使 
。 关 于 JSON 协 议 的 内 容 我 们 会 在 本 书 3.3 节 中 详细 介绍 。 


1.3 ”如 何 学 习 Android 和 PHP 


前 面 我 们 已 经 讨论 过 “为 何 学 ”的 问题 ， 大 家 应 该 对 Android 加 PHP 这 套 应 用 开发 解决 方案 有 了 大 致 的 了 解 。 接 下 来 介绍 “如 何 学 ”的 问题 ， 由 于 本 书 的 内 容 比较 广泛 ， 既 涉及 客户 端 开 发 的 技术 也 包 
含 很 多 服务 端 开 发 的 内 容 ， 所 以 在 正式 开始 学 习 本 书 之 前 ， 先 搞 清楚 应 该 使 用 什么 样 的 学 习 方法 比较 有 效 是 非常 有 必要 的 。 接 下 来 ， 笔 者 会 把 这 个 问题 分 解 为 以 下 几 个 部 分 来 探讨 。 


1.3.1 如 何 学 习 Android 


由 于 Android 学 习 是 本 书 最 核心 的 内 容 ， 因 此 我 们 先 来 分 析 。 由 于 Android 应 用 框架 是 基于 Java 语 言 的 ， 所 以 在 学 习 Android 之 前 ， 最 理想 的 状态 是 您 已 经 具有 一 定 的 Java 语 言 编程 基础 ， 对 Java 语 言 
常用 语法 和 常用 类 包 (package) 的 使 用 也 有 一 定 的 认识 。 当 然 ， 即 使 您 是 一 名 Java 初 学 者 ， 同 样 也 可 以 从 本 书 中 学 到 一 些 非常 有 用 的 Java 编 程 的 经 验 。 以 下 是 Android SDK 中 包含 的 一 些 比较 重要 的 Java 
基础 类 包 ， 建 议 大 家 先 自行 熟悉 起 来 。 


表 1-1 Android SDK 中 的 重要 Java 基 础 类 包 


Java 类 包 名 作用 

java.io Java 普通 IO 包 

Java.nio Java FA VO 包 

java.lang Java 基础 语言 包 

java.math Java 算数 类 包 ( 提供 高 精度 计算 ) 

java.net Java 基础 网 络 接口 包 ( URILURL ) 

Java.text Java 文本 通用 接口 包 ( DateFormat/NumberFormat ) 
java.util Java 常用 辅助 工具 包 ( ArrayList/HashMap ) 
javax.crypto Java 基础 加 解密 工具 包 ( Cipher ) 

javax.xml Java 的 Xml 工具 类 包 ( SAXParser ) 
org.apache.http Java 的 Http 网 络 工 具 包 ( HttpClient ) 

org.json Java 的 Json 工具 类 包 ( ISONObject/ISONArray ) 


当然 ， 在 Android SDK 中 除了 以 上 这 些 Java 基 础 包 之 外 ， 更 多 的 还 是 Android 系 统 本 身 的 功能 类 包 。 当 然 ， 如 果 要 查阅 更 多 关于 Android 类 包 的 说 明文 档 ， 就 需要 参考 Android 的 SDK 文 档 了 。 我 们 可 以 
在 浏览 器 中 打开 Android 的 SDK 里 的 docs/reference/packages.html 网 页 进行 查阅 。 想 要 把 这 里 面 的 类 包 全 部 弄 懂 ， 必 将 是 一 个 漫长 而 艰苦 的 过 程 。 当 然 ， 假 如 坚持 到 了 那 一 天 ， 我 相信 你 也 已 经 成 为 
Android 大 师 了 。 


结合 本 书 来 讲 ， 如 果 你 没有 任何 的 Java 编 程 经 验 或 者 Android 基 础 ， 那 么 一 定 要 更 加 认真 地 阅读 本 书 第 2 章 的 内 容 ， 此 章 不 仅 对 Android 系 统 框架 和 应 用 框架 进行 了 精辟 的 讲解 ， 而 且 结 合 实例 让 你 快速 
熟悉 Android 的 开发 框架 。 接 下 去 ， 在 阅读 完 本 书 “ 实 战 篇 ”的 内 容 并 慢 慢 熟悉 Android 开 发 之 后 ， 还 要 注意 学 习 和 理解 “优化 篇 ”中 关于 系统 优化 的 技巧 ， 因 为 没有 经 过 优化 的 系统 是 非常 脆弱 的 。 只 有 在 
把 本 书 “ 实 战 篇 ” 和 “优化 篇 ”的 内 容 全 部 理解 透彻 之 后 ， 才 能 往 下 学 习 “ 进 阶 篇 ”的 内 容 。 总 而 言 之 ， 学 习 Android 开 发 一 定 要 坚持 “稳扎稳打 ， 层 层 递 进 ” 的 学 习 原 则 ， 这 样 才能 达到 最 佳 的 学 习 效 
=. 


13.2 ”如 何 学 习 PHP 


可 能 很 多 人 会 认为 PHP 学 起 来 比较 简单 ， 事 实 也 确实 如 此 ， 但 是 这 并 不 意味 着 我 们 可 以 很 轻易 地 掌握 使 用 PHP 进 行 服务 端 开 发 的 技巧 。 由 于 服务 端 编程 涉及 的 知识 面 比较 广 ， 除 了 编程 语言 本 身 ， 还 需 
要 和 很 多 的 服务 端 组 件 打交道 ， 比 如 HTTP 服 务 器 、 缓 存 中 间 件 、 数 据 库 等 ， 所 以 我 们 也 需要 做 好 “刻苦 学 习 ” 的 准备 。 


如 果 你 没有 任何 PHP 开 发 基础 ， 请 认真 阅读 本 书 第 3 章 ， 因 为 该 章 能 够 让 你 快速 地 掌握 PHP 语 言 的 基础 知识 ， 以 及 在 开发 中 比较 常见 的 服务 端 组 件 的 使 用 方法 。 接 下 来 ， 当 你 看 完 本 书 第 6 章 之 后 ， 我 相 
信 你 应 该 会 对 如 何 使 用 PHP 进 行 移动 应 用 的 服务 端 开发 有 了 相当 的 认识 。 另 外 ， 和 学 习 Android 开 发 一 样 ， 我 们 同样 要 重视 “优化 篇 ” 中 关于 PHP 语 言 以 及 服务 端 优化 的 技巧 ， 相 信 这 些 内 容 会 让 你 的 PHP 
编程 技巧 甚至 服务 端 架构 的 功力 更 进一步 。 


在 学 习 PHP 的 过 程 中 一 定 要 注意 的 是 ， 要 善于 使 用 PHP 的 文档 资源 ， 最 好 是 边 学 习 、 边 动手 、 边 查 文档 。 另 外 ， 笔 者 一 直 认为 PHP 语 言 文档 的 完备 程度 是 可 以 和 大 名 易 易 的 MSDN 相 比 的 。 最 后 ， 要 充 
分 利用 如 下 PHP 的 文档 资源 。 


- 官方 中 文 文档 : http://www.php.net/manual/zh/ 


- 官方 扩展 库 : http://pecl.php.net/packages.php 


1.3.3 ”同时 学 好 Android 和 PHP 


也 许 在 以 前 ， 同 时 学 习 Android 系 统 和 PHP 语 言 是 一 件 很 不 可 思议 的 事情 ,但 是 ， 在 有 了 本 书 之 后 ， 同 时 学 好 这 两 种 主流 的 技术 不 再 只 是 一 个 梦想 。 当 然 ， 我 们 更 不 
两 种 技术 绝对 是 一 件 一 举 两 得 的 好 事 ! 


首先 ， 编 程 的 技术 其 实 是 相通 的 ， 每 门 编程 语言 都 有 自己 的 优势 和 缺点 ， 就 拿 Java 和 PHP 来 说 ， 
FS EBERT 


到 PHP 的 程序 设计 中 去 ;而 简 和 


得 使 


其 次 ， 从 就 业 的 角度 来 说 ， 大 家 都 知道 目前 站 
域 最 受 欢迎 的 技术 人 才 之 一 。 此 外 ， 根 据 笔者 多 年 


很 希望 本 书 能 成 为 你 踏 上 成 功 之 路 的 一 块 踏板 。 


回 到 如 何 学 习 Android 和 PHP 的 问题 上 来 。 首 先 ， 我 们 需要 清楚 的 是 : Android 代 表 的 是 客户 端 开发 ， 而 PHP 涉 及 的 则 是 服务 端 开 发 ， 


和 数组 操作 是 PHP 的 优势 ， 那 么 我 们 在 学 习 Java 的 时 候 就 需 
类 似 以 上 提 到 的 “取长补短 ” 式 的 思路 进行 学 习 ， 不 仅 大 大 有 益 于 我 们 对 这 两 种 技术 的 学 习 和 运 


怀疑 ， 能 同时 学 好 Android 和 PHP 


良好 的 类 库 设 计 和 面向 对 象 思想 是 java 的 优点 ， 那 么 在 学 习 的 时 候 我 们 就 应 当 思考 如 何 把 这 些 优点 运 
考虑 怎么 把 这 部 分 的 接口 方法 设计 得 更 简洁 一 些 。 假 如 我 们 在 学 习 Android 和 PHP 的 过 程 中 ， 懂 
， 甚 至 还 可 以 加 强 日 后 学 习 其 他 技术 的 能 力 。 


和 6 场 上 最 紧缺 的 就 是 综合 性 的 人 才 ， 特 别 地 ， 对 于 移动 互联 网 领域 来 说 ， 既 掌握 Android 客 户 端 开 发 ， 又 通晓 PHP 服 务 端 编程 的 开发 者 绝对 是 移动 互联 网 领 
F 的 职场 经 验 来 看 ， 多 掌握 几 种 技术 总 归 是 一 件 好 事 ， 


很 难说 在 未 来 的 哪 一 天 就 可 能 会 派 上 大 用 场 。 


另外 ， 如 果 你 对 技术 方面 有 更 长 远 的 职业 规划 ， 笔 者 也 


想 把 两 者 结合 起 来 ， 我 们 必须 通过 一 个 第 三 方 的 文本 协议 


JSON。 对 JSON 不 熟悉 的 朋友 可 以 先 学 习 一 下 本 书 3.3 节 的 内 容 。 另 外 ，Android 客 户 端 开发 和 PHP 服 务 端 开发 ， 使 用 的 是 两 种 完全 不 同 的 语言 ， 要 同时 学 好 两 者 当然 不 是 一 件 容易 的 事情 。 因 此 ， 在 学 习 的 


时 候 ， 我 们 要 注意 采 


总 之 ， 想 要 同时 学 好 Android 和 PHP， 不 仅 要 求 大 家 有 比较 坚实 的 编程 基础 知识 ， 还 需要 注意 学 习 和 思考 的 方式 ， 把 两 者 看 做 一 个 整体 来 进行 比 对 学 习 。 本 书 在 “准备 篇 ” 中 把 Android 和 PHP 开 发 的 基 


础 知识 讲解 完 之 后 ， 还 会 在 “实战 篇 ”中 给 大 家 安排 “ 微 博 应 
读 完 本 书 之 后 ， 你 已 经 对 Android 加 PHP 的 这 套 技术 解决 方案 了 然 了 
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在 本 章 中 ， 我 们 实际 上 讨论 了 几 个 前 期 问题 : 为 什么 要 学 习 Android 移 动 互 联网 应 


“ 比 对 式 ”的 方式 去 学 习 和 思考 Android 和 PHP 这 两 套 不 同 的 知识 体系 ; 同时 ， 我 们 也 需要 注意 怎样 使 


”作为 实例 进行 讲解 ， 该 应 


JSON 协 议 把 这 两 套 系 统 联合 起 来 ， 形 成 一 个 整体 。 


是 一 个 把 Android 客 户 端 开发 和 和 PHP 服务 端 开 发 相 结合 的 绝 佳 案例 ， 大 家 可 以 边 学 习 理 解 、 边 动手 研究 。 


如 果 


胸 的 话 ， 那 么 我 要 恭喜 你 已 经 跨 出 了 迈 向 成 功 的 重要 一 步 。 


开发 ? 为 什么 要 使 


Android 和 PHP 的 架构 来 进行 开发 ? 如 何 学 习 ? 相信 现在 大 家 都 已 经 找到 自己 的 答案 了 ， 那 么 在 


以 下 的 章节 中 我 们 就 要 开始 正式 地 学 习 如 何 开 发 了 。 在 第 2 章 和 第 3 章 中 ， 我 们 将 分 别 学 习 Android 和 PHP 的 开发 基础 和 技巧 。 


第 2 章 Android 开 发 准备 


在 开始 学 习 Android 开 发 之 前 ， 让 我 们 先 来 了 解 一 个 有 趣 的 Android 小 知识 : Android 一 词 最 早出 现 于 法 国 作家 利 尔 亚当 在 1886 年 发 表 的 科幻 小 说 《未 来 夏娃 》 中 ， 书 中 将 外 表 像 人 的 机 器 起 名 为 


Android (不 知道 是 不 是 和 Angel 同 音 的 缘故 ) ， 正 


本 章 将 先 对 Android 系 统 框 架 、Android 应 F 


2.1 Android 背 景 知识 


Android 是 一 种 基于 Linux 平 台 的 、 
制造 商 组 成 “开放 手机 联盟 ”对 其 进行 开发 改良 ， 并 逐渐 扩展 到 平板 电脑 及 其 


Android 平 台 的 研发 队伍 十 分 强大 ， 包 括 Google、HTC、T-Mobile、 高 通 、 摩 托 罗拉 、 三 星 、LG 以 及 中 国 移动 在 内 的 30 多 家 产 商 都 将 基于 该 平台 开发 手机 新 型 业务 。 当 然 ， 使 


因为 如 此 ，Android 的 商标 


框架 以 及 Android 应 用 开发 过 程 中 的 几 个 要 点 做 一 个 整体 性 的 介绍 ， 让 大 家 尽快 做 好 Android 应 
会 如 何 安装 Android 开 发 环境 和 Android 开 发 的 必 备 工具 (Eclipse 加 ADT) ， 并 建立 你 的 第 一 个 Android 项 目 ， 即 Hello World 项 


也 是 一 个 绿色 的 小 机 器 人 。 


BS 


， 大 家 都 知道 Android 代 表 的 是 Google 推 出 的 开源 智能 移动 终端 操作 系统 。 


开发 的 准备 工作 。 另 外 ， 在 本 章 的 最 后 两 节 ， 我 们 还 将 学 
， 由 此 开始 你 的 Android 开 发 之 旅 。 


源 的 、 智 能 移动 终端 的 操作 系统 ， 主 要 使 用 于 便携 设备 ，Android 操 作 系 统 最 初 由 Andy Rubin 开 发 ， 主 要 支持 手机 设备 。2005 年 由 Google 收 购 注资 ， 并 召集 多 家 
他 领域 ， 近 年 来 逐渐 成 为 主流 的 移动 终端 操作 系统 之 一 。 


Android 这 个 统一 的 


平台 进行 开发 ， 对 于 我 们 开发 者 来 说 也 是 一 大 福音 ， 至 少 在 软件 应 用 的 通 


1.0 开 始 ， 在 接 下 来 的 几 年 中 ，Android 一 直 在 以 惊人 的 速度 成 长 着 ， 直 型 


吧 ! 


性 方面 ， 我 们 不 需要 过 多 考虑 。 但 是 ， 你 知道 吗 ? 如 此 强大 的 Android 系 统 实际 上 才刚 满 4 周岁 ， 从 2008 年 9 月 发 布 的 Android 
今天 成 为 占领 全 球 半数 市 场 的 “ 巨 无 霸 ” 


， 这 个 成 绩 可 以 算得 上 是 一 个 奇迹 了 。 让 我 们 通过 下 表 来 回顾 一 人 Android 的 成 长 之 路 


表 2-1 Andtoid 成 长 之 路 


版 本 发 布 时 间 主要 改进 
Android 1.5 2009 年 4 月 1. 拍摄 /播放 影片 
Cupcake 2. 支持 立体 声 蓝 牙 耳 机 

3. 最 新 的 采用 WebKit 技术 的 浏览 器 

4. 支持 复制 /粘贴 和 页 面 中 搜索 


Ra E 


Android 1.6 


Android 2.072172 2 
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版 本 发 布 时 间 主要 改进 
Android 3.0 2011 年 2 月 1. 针对 平板 的 优化 
Honeycomb 2. 全 新 设计 的 UI 增强 网 页 浏览 功能 
3. 增加 n-app purchases 功能 
Android 3.1 2011 年 5 月 1. 优化 Gmail 电子 邮箱 
Honeycomb 2. 全 面 支持 Google Map 
3. 将 Android 手机 系统 跟 平板 系统 再 次 合并 
4. 任务 管理 器 可 滚动 支持 USB 输入 设备 ( 键盘 、 鼠 标 等 ) 
5. 支持 Google TV， 可 以 支持 XBOX 360 无 线 手 柄 
6. 更 加 容易 地 定制 屏幕 widget 插件 
Android 3.2 2011 年 7 月 1. 支持 更 多 屏幕 尺寸 的 设备 
Honeycomb 2. 引 人 了 应 用 显示 缩放 功能 
Android 4.0 2012 年 1. 增强 任务 系统 ， 人 性 化 系统 手势 
Ice Cream 2. 优化 UI， 支 持 自动 缩放 
3. 增强 语音 功能 
4. 增强 云 服 务 
Android 4.1/4.2/4.3 2012 ~ 2014 E 1. 增加 泻 染 效率 
Jelly Bean 2. 增强 通知 中 心 
3. 增强 搜索 和 订阅 功能 能 
4. 向 硬件 生产 商 提供 开放 平台 开发 套件 PDK 
Android N.n 未 知 继 Ice Cream 之 后 的 下 一 版 Android 系统 
Jelly Bean 


从 上 表 中 ， 大 家 不 仅 可 以 了 解 Android 系 统 的 发 


Android 2.2 版 本 上 安装 /调试 的 。 


2.2 Android 系 统 框架 


在 开始 介绍 Android 应 


这 个 部 分 内 容 却 是 必 不 可 少 的 ， 因 为 能 否 理解 Android 的 系统 架构 对 于 你 日 后 能 否 对 Android 进 行 更 深入 的 学 习 是 至 关 重 要 的 。 首 先 ， 我们 来 看 一 张 不 得 不 说 的 


统 框架 图 ， 如 图 2-1 所 示 。 


展 历程 ， 而 且 可 以 了 解 Android 系 统 在 功能 改进 上 的 一 些 细节 。 另 外 ， 需 要 大 家 注意 的 是 ， 考 虑 到 对 目前 大 部 分 设备 的 兼容 性 ， 本 书 下 面 的 项 目 实例 是 在 


开发 之 前 ， 我 们 先 来 了 解 一 人 Android 的 系统 框架 。 昌 然 ， 是 否 了 解 Android 系 统 框架 与 能 否 进行 Android 应 用 开发 之 间 没 有 任何 必然 的 联系 ， 但 是 在 学 习 Android 的 过 程 中 ， 


图 ， 也 就 是 Google 官 方 公布 的 Android 的 系 


从 图 2-1 展 示 的 Android 系 统 架构 图 可 以 很 清晰 看 出 ，Android 系 统 分 为 四 层 : 应 用 层 、 应 用 框架 层 、 系 统 类 库 层 和 系统 内 核 层 。 下 面 我 们 将 对 这 四 个 层次 做 一 些 简 要 的 分 析 和 介绍 。 


1. 应 用 层 (Applications) 


应 用 层 (Applications) 是 指 运行 于 Android 虚 拟 机 上 的 程序 ， 也 就 是 开发 者 们 平时 开发 的 “手机 应 用 ”。 在 系统 应 用 层 里 ， 我 们 可 以 通过 Android 提 供 的 组 件 和 API 进 行 开 发 ， 从 而 编写 出 形形色色 、 


丰富 多 彩 的 移动 软件 和 游戏 。 


2. 应 用 框架 层 (Application Framework) 


应 用 框架 层 (Application Framework) 是 Android 应 用 开发 的 核心 ， 为 开发 者 开发 应 用 时 提供 基础 的 API 框 架 。 当 然 ，Android 本 身 的 很 多 核心 应 用 也 是 在 这 层 的 基础 上 开发 的 。 下 面 我 们 就 来 了 解 一 
下 这 些 模块 的 作用 ( 见 表 2-2) 。 


模块 名 
1 View System 
2 Activity Manager 
3 Window Manager 
4 Resource Manager 
5 Location Manager 
6 Content Providers 
7 Package Manager 
8 Notification Manager 


Telephony Manager 
10 XMPP Service 


图 2-1 ”Android 系统 框架 
表 2-2 应 用 框架 层 主 要 模块 


模块 简介 


主要 用 于 UI 设计 ， 包 括 列 表 (List)、 网 格 (Grid)、 文 本 框 (Text)、 按 钮 
( Button ) ELA AX, Web 浏览 器 ( WebView ) 等 

负责 管理 应 用 程序 中 Activity 的 生命 周期 以 及 提供 Activity 之 间 的 切换 功能 
( Intent 相关 ) 

用 于 管理 所 有 的 窗口 程序 ， 如 Dialog, Toast 等 

提供 非 代 码 资源 的 管理 ， 如 布局 文件 、 图 形 、 字 符 串 等 

负责 与 定位 功能 LBS ( Location Based Service ) 相关 功能 

提供 了 一 组 通用 的 数据 访问 接口 ， 可 用 于 应 用 程序 间 的 内 容 交 互 ， 比 如 可 以 用 于 
获取 手机 联系 人 数据 等 

Android 系统 内 的 包 管理 模块 ， 负 责 管理 安装 的 应 用 程序 

用 于 管理 手机 状态 栏 中 的 自 定义 信息 等 

手机 底层 功能 管理 模块 ， 可 用 于 获取 手机 串 号 或 者 调用 短信 功能 

用 于 支持 XMPP 协议 的 服务 ， 比 如 与 Google Talk 通信 等 


以 上 列 出 的 模块 都 是 我 们 在 应 用 开发 中 经 常用 到 的 ， 大 家 可 以 先 熟悉 一 下 。 其 中 最 核心 的 Activity Manager 和 View System 我 们 将 分 别 在 2.3 节 和 2.7 节 中 作 详 细 介绍 。 此 外 ， 其 他 常用 的 Android 模 块 的 


相关 内 容 我 们 也 会 在 本 书 以 后 的 章节 中 穿插 介绍 。 


3. 系 统 类 库 层 (Libraries) 


为 了 支持 上 层 应 用 的 运行 ，Android 会 通过 系统 类 库 层 (Libraries) 中 的 一 些 比较 底层 的 C 和 C++ 库 来 支持 我 们 所 使 用 的 各 个 组 件 或 者 模块 。 以 下 列举 一 些 比较 重要 的 类 库 的 功能 ， 这 个 部 分 大 家 了 解 即 


- Surface Manager: 负责 管理 显示 与 存储 之 间 的 互动 ， 以 及 对 2D 绘 图 和 3D 绘 图 进行 显示 上 的 合成 。Android 中 的 图 形 系 统 实际 上 采用 的 是 C/S 结 构 ，Client 端 就 是 应 用 程序 ， 而 Server 端 是 Surface 


Flinger, Client% 18 1$ Binder @Server 4% Surface Flinger 传 输 图 像 数 据 ， 最 终 由 Surface Flinger 合 成 到 Frame Buffer 中 ， 然 后 在 屏幕 上 显示 出 来 。 
: Media Framework: Android 的 多 媒体 库 ， 该 库 支持 多 种 常见 格式 的 音频 和 视频 的 播放 、 录 制 等 各 种 操作 ， 比 如 JPG、PNG、MPEG4、MP3、AAC、AMR 等 。 
- SQLite: Android 自 带 的 关系 数据 库 ， 可 用 于 存储 复杂 数据 。 
: OpenGL/ES: 3D 效 果 库 ， 主 要 用 于 3D 游 戏 开 发 。 
- FreeType: 支持 位 图 、 和 拓 量 、 字 体 等 。 
: WebKit: Android 的 Web 浏 览 器 内 核 (和 iOS 一 样 ) 。 
- SGL: 2D 图 形 引擎 库 。 
+ SSL: 安全 数据 通信 支持 。 


- Libc: 也 就 是 Bionic 系 统 C 库 ， 当 前 支持 ARM 和 x86 指 令 集 。 该 库 非 常 小 巧 ， 主 要 用 于 系统 底层 调用 ， 在 NDK 中 经 常会 使 用 到 。 


4. 系 统 内 核 层 (Linux Kernel) 


Android 内 核 具 有 和 标准 的 Linux 内 核 一 样 的 功能 ， 主 要 实现 了 内 存 管理 、 进 程 调度 、 进 程 间 通 信 等 功能 。 就 最 新 的 Android 内 核 源码 树 的 根 目录 结构 来 看 ，Android 内 核 源码 与 标准 Linux 内 核 并 无 不 
同 ; 但 是 ， 经 过 与 标准 Linux 内 核 源 代码 进行 详细 对 比 ， 可 以 发 现 Android 内 核 与 标准 Linux 内 核 在 文件 系统 、 进 程 间 通 信 机 制 、 内 存 管理 等 方面 存在 着 不 同 。 当 然 ， 了 解 它们 之 间 的 区 别 对 进一步 了 解 
Android 系 统 是 有 很 大 帮助 的 ， 下 面 我 们 从 几 个 方面 来 分 析 两 者 之 间 的 异同 。 


“ 文件 系统 。 不 同 于 桌面 系统 与 服务 器 ， 移 动 设备 采用 的 大 多 不 是 硬盘 而 是 Flash 作 为 存储 介质 。 因 此 ，Android 内 核 中 增加 了 标准 Linux 专 用 于 Flash 的 文件 系统 YAFFS2。YAFFS2 是 日 志 结 构 的 文件 系统 ， 
提供 了 损耗 平衡 和 掉 电 保护 ， 可 以 有 效 地 避免 意外 断 电 对 文件 系统 一 致 性 和 完整 性 的 影响 。 经 过 测试 证 明 ，YAFFS2 性 能 比 支持 NOR 型 闪存 的 JFFS2 文 件 系 统 更 加 优秀 。YAFFS2 对 Nand-Flash 芯 片 也 有 着 良好 
的 支持 。 


- 进程 间 通 信 机 制 。Android 增 加 了 一 种 进程 间 的 通信 机 制 IPC Binder。Binder 通 过 守护 进程 Service Managet 管 理 系统 中 的 服务 ， 负 责 进 程 间 的 数据 交换 。 各 进程 通过 Binder 访 问 同一 块 共享 内 存 ， 以 达到 数 
据 通 信 的 机 制 。 从 应 用 层 的 角度 看 ， 进 程 通过 访问 数据 守护 进程 获取 用 于 数据 交换 的 程序 框架 接口 ， 调 用 并 通过 接口 共享 数据 ， 而 其 他 进程 要 访问 数据 ， 也 只 需 与 程序 框架 接口 进行 交互 ， 方 便 了 程序 员 开 
发 需要 交互 数据 的 应 用 程序 。 


“ 内 存 管 理 。 在 内 存 管理 模块 上 ，Android 内 核 采用 了 一 种 不 同 于 标准 Linux 内 核 的 低 内 存 管理 策略 。Android 系 统 采用 的 是 一 种 叫 作 LMK (Low Memory Killer) 的 机 制 ， 这 种 机 制 将 进程 按照 重要 性 进行 分 
级 、 分 组 ， 内 存 不 足 时 ， 将 处 于 最 低级 别 组 的 进程 关闭 ， 保 证 系统 是 稳定 运行 的 。 同 时 ，Android 新 增加 了 一 种 内 存 共 享 的 处 理 方 式 Ashmem (Anonymous Shared Memory， 匿 名 共享 内 存 ) 。 通 过 Ashmem， 进 
程 间 可 以 匿名 自由 共享 具名 的 内 存 块 ， 这 种 共享 方式 在 标准 Linux 当 中 也 是 不 被 支持 的 。 


: 电源 管理 。 由 于 Android 主 要 用 于 移动 设备 ， 电 源 管理 就 显得 尤为 重要 。 不 同 于 标准 Linux 内 核 ，Android 采 用 的 是 一 种 较为 简单 的 电源 管理 策略 ， 通 过 开关 屏幕 、 开 关 屏 幕 背光 、 开 关键 盘 背 光 、 开 关 
按钮 背光 和 调整 屏幕 亮度 来 实现 电源 管理 ， 并 没有 实现 休眠 和 待机 功能 。 目 前 有 三 种 途径 判断 调整 电源 管理 策略 : RPC 调 用 、 电 池 状 态 改变 和 电源 设置 。 系 统 通过 广播 Intent 或 直接 调用 API 的 方式 来 与 其 他 
模块 进行 联系 。 电 源 管理 策略 同时 还 有 自动 关机 机 制 ， 当 电力 低 于 最 低 可 接受 程度 时 ， 系 统 将 自动 关机 。 另 外 ，Android 的 电源 管理 模块 还 会 根据 用 户 行为 自动 调整 屏幕 亮度 。 


: 驱动 及 其 他 。 相 对 于 标准 内 核 ，Android 内 核 还 添加 了 字符 输出 设备 、 图 像 显示 设备 、 键 盘 输 入 设备 、RTC 设 备 、USBDevice 设 备 等 相关 设备 驱动 ， 增 加 了 日 志 (Logger) 系统 ， 使 应 用 程序 可 以 访问 日 
志 消 息 ， 使 开发 人 员 获得 更 大 的 自由 。 


2.3 Android 应 用 框架 


前 面 介绍 了 Android 的 系统 框架 ， 主 要 目的 是 让 大 家 对 Android 系 统 有 整体 的 概念 ， 也 为 日 后 更 深入 的 学 习 打 好 基础 。 然 而 ， 目 前 我 们 更 需要 生 
握 和 理解 Android 应 用 框架 ， 直 接 关 系 到 是 否 能 学 好 Android 应 用 开发 。 


学 习 和 掌握 的 则 是 Android 的 应 用 框架 ， 因 为 是 否 能 掌 


Android 的 应 用 框架 是 一 个 庞大 的 体系 ， 想 要 理解 透彻 并 不 是 那么 简单 的 事情 ， 但 是 ， 好 在 其 中 有 一 些 比较 清晰 的 脉络 可 以 帮助 我 们 快速 地 熟悉 这 个 系统 ， 因 此 抓 住 这 些 脉络 中 的 核心 要 点 对 于 能 否 学 
好 Android 的 应 用 开发 来 说 是 至 关 重要 的 。 一 般 来 说 ，Android 应 用 框架 中 包含 四 个 核心 要 点 ， 即 活动 (Activity) 、 消 息 (Intent) 、 视 图 (View) 和 任务 (Task) . 


如 果 你 觉得 上 述 核心 要 点 的 概念 很 陌生 ， 不 好 理解 ， 那 么 我 们 来 看 看 下 面 这 个 比喻 : 如 果 把 一 个 Android 应 用 比喻 成 海洋 ， 那 么 每 个 Activity 就 是 这 个 海洋 中 的 岛屿 ， 假 设 我 们 眼前 有 一 项 任务 (也 就 是 
Task) ， 需 要 我 们 在 其 中 若干 个 岛屿 上 建立 起 自己 的 王国 。 于 是 问题 来 了 ， 我 们 要 怎么 样 从 一 座 岛屿 去 到 另 一 座 岛 屿 呢 ? 没 错 ， 我 们 需要 交通 工具 ， 而 Intent 就 是 我 们 最 重要 的 交通 工具 。 当 然 ，Intent 不 
仅 可 以 带 我 们 去 ， 而 且 还 可 以 帮 有 我 们 带 上 很 多 需要 的 东西 。 接 着 ， 到 了 岛 上 ， 我 们 开始 建立 一 个 自己 的 王国 ， 要 知道 这 可 需要 很 多 的 资源 ， 这 个 时 候 ， 我 们 就 会 想到 View 这 个 建筑 公司 ， 因 为 他 可 以 帮助 我 
们 快速 地 建 出 我 们 需要 的 东西 。 这 样 ，Activity、Intent、View 以 及 Task 一 起 配合 完成 了 一 个 完整 的 Android 应 用 的 王国 。 


从 以 上 的 比喻 中 ， 我 们 还 可 以 认识 到 ， 在 这 四 个 要 点 中 ，Activity 是 基础 ，Intent 是 关键 ，View 是 必要 工具 ， 而 Task 则 是 开发 的 脉络 。 对 于 开发 者 来 说 ， 只 有 掌握 了 Activity、Intent、View 和 Task 这 几 
个 核心 要 素 之 后 ， 才 能 够 做 出 多 种 多 样 的 应 用 程序 。 接 下 来 ， 让 我 们 分 别 学 习 一 下 这 四 个 核心 要 点 。 


2.3.1 活动 (Activity) 


活动 (Activity) 是 Android 应 用 框架 最 基础 、 最 核心 的 内 容 和 元 素 ， 每 个 Android 应 用 都 是 由 一 个 或 者 若干 个 Activity 构 成 的 。 在 Android 应 用 系统 中 ，Activity 的 概念 类 似 于 界面 ， 而 Activity 对 象 我 们 
通常 称 之 为 “界面 控制 器 ” (从 MVC 的 角度 来 说 ) 。 从 另 一 个 角度 来 理解 ，Activity 的 概念 比较 类 似 于 网 站 (Web) 开发 中 “网 页 ”的 概念 。 此 外 ， 当 Android 应 用 运行 的 时 候 ， 每 个 Activity 都 会 有 自己 独 
立 的 生命 周期 ， 图 2-2 所 示 的 就 是 Activity 的 生命 周期 。 
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其 实 ， 在 Android 系 统 内 部 有 专门 的 Activity 堆 栈 (Stack) 空间 ， 
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于 存储 多 个 Activity 的 运行 状态 。 一 般 来 说 ， 系 统 会 保证 某 一 时 刻 只 有 最 顶端 的 那个 Activity 是 处 于 前 端的 活动 (foreground) 状 


态 。 也 正 因 如 此 ， 一 个 Activity 才 会 有 如 图 2-2 所 示 的 生命 周期 。 当 一 个 Activity 启 动 并 进入 活动 状态 的 时 候 ， 调 用 顺序 是 onCreate、onStart、onResume; 退 居 后 台 的 时 候 ， 调 用 顺序 是 onPause、 


onStop; 重新 回 到 活动 状态 的 时 候 ， 调 用 顺序 是 onRestart、onstart、onResume; 销毁 的 时 候 ， 调 用 顺序 是 onPause、onStop、onDestroy。 我 们 应 该 深刻 理解 这 些 状 态 的 变化 过 程 ， 因 为 在 Android 


应 用 开发 的 过 程 中 我 们 会 经 常 
的 使 用 。 


到 。 至 于 如 何 更 好 地 掌握 Activity 的 特性 ， 大 家 可 以 尝试 将 以 下 代码 (代码 清单 2-1) 放 入 Android 应 


中 运行 ， 并 对 照 程序 打印 出 的 调试 信息 来 理解 Activity 生 命 周 期 各 阶段 


代码 清单 ”2-1 


// 基础 Activity 类 ， 用 于 测试 
public class BasicActivity extends Activity { 
private String TAG = this.getClass () .getSimpleName () ; 
public void onCreate (Bundle savedInstanceState) { 
Log.w(TAG, "TaskId:"+this.getTaskId()); 


} 
public void onSt 
super.onSt 


art() ( 
art(); 


Log.w(TAG, "onStart"); 

} 

public void onRestart() { 
super.onStart (); 
Log.w(TAG, "onRestart"); 

li 

public void onResume() ( 
super.onResume () ; 


Log.w (TAG, 


"onResume"); 


} 
public void onPause() { 
super.onPause () ; 


Log.w (TAG, 
} 
public void onSt 
super.onSt 
Log.w (TAG, 


} 

public void onDe 
super.onDe 
Log.w (TAG, 


"onPause"); 


op() { 
op () ; 
"onStop"); 


stroy() { 
stroy(); 
"onDestroy"); 


š 
public void onNewIntent () 


{ 


Log.w(TAG, "onNewIntent"); 


) 


此 外 ， 所 有 的 Activity 必 须 在 项 目 基础 配置 文件 AndroidManifest.xml 中 声明 ， 这 样 Activity 才 可 以 被 Android 应 | 
Activity 声 明 的 具体 操作 ， 我 们 会 在 2.10.2 节 中 结合 Hello World Eit T4 


框架 所 识别 ;如 果 你 只 写 了 Java 代 码 而 不 进行 声明 的 话 ， 运 行 时 就 会 地 出 
介绍 。 


ActivityNotFoundException 异 常 。 关 了 


2.3.2 消息 (Intent) 


参考 之 前 我 们 对 Android 应 用 框架 的 几 个 核心 要 点 的 比喻 ， 我 们 应 该 知道 Intent 消 息 模块 对 于 Android 应 上 
可 能 构成 一 个 完整 的 系统 。 在 Android 应 用 系统 中 ， 我 们 常常 把 Intent 称 为 消息 ， 实 


框架 来 说 有 多 重要 ; 如 果 没 有 它 的 话 ，Android 应 用 的 各 个 模块 就 像 一 座 座 “ 孤 岛 ”， 根 本 不 
示 上 ，Intent 本 身 还 是 一 个 对 象 ， 里 面包 含 的 是 构成 消息 的 内 容 和 属性 ， 主 要 有 如 下 几 个 属性 ,我 们 来 分 别 认识 一 下 。 


1. 组 件 名 称 (ComponentName) 


对 于 Android 系 统 来 说 ， 组 件 名 称 实际 上 就 是 一 个 ComponentName 对 象 ， 


于 指定 Intent 对 应 的 


标 组 件 ，Intent 对 象 可 以 通过 setComponent、setClass 或 者 setClassName 方 法 来 进行 设置 。 


2 动作 (Action) 


消息 基 类 (Intent) 中 定义 了 各 种 动作 常量 (字符 串 常量 ) ， 其 中 比较 常见 的 有 : ACTION MAIN (对 应 字符 串 android.intent.action.MAIN) 表示 应 
符 串 android.intent.action.EDIT) 表示 常见 的 编辑 动作 ; ACTION CALL (对 应 字符 串 android.intent.action.CALL) 则 表示 上 


的 入 口 的 初始 化 动作 ; ACTION EDIT (对 应 字 
于 初始 化 电话 模块 动作 等 。Intent 对 象 常 使 用 setAction 方 法 来 设置 。 


3 数据 (Data) 


不 同 的 动作 对 应 不 同 的 数据 (Data) 类 型 ， 比 如 ACTION_EDIT 动 作 可 能 对 应 的 是 用 于 编辑 文档 的 URI;， 而 ACTION_CALL 动 作 则 应 该 包含 类 似 于 tel: xxx 的 URI。 多 数 情况 下 ， 数 据 类 型 可 以 从 URI 的 格 
式 中 获取 ， 当 然 ，Intent 也 支持 使 用 setData、setType 方 法 来 指定 数据 的 URI 以 及 数据 类 型 。 


4. 类 别 (Category) 


既然 不 同 的 动作 应 该 对 应 不 同 的 数据 类 型 ， 那 么 不 同 的 动作 也 应 该 由 不 同 的 类 别 的 Activity 组 件 来 处 理 ， 比 如 CATEGORY_BROWSABLE 表 示 该 Intent 应 该 由 浏览 器 组 件 来 打 
开 ，CATEGORY_LAUNCHER 表 示 此 Intent 由 应 用 初始 化 Activity 处 理 ; 而 CATEGORY_PREFERENCE 则 表示 处 理 该 Intent 的 应 该 是 系统 配置 界面 。 此 外 ， 消 息 对 象 (Intent) 可 以 使 
种 类 型 ， 而 一 个 Intent 对 象 也 可 以 包含 多 种 类 型 属性 。 


addCategory 添 加 一 


5. 附 加 信息 (Extras) 


一 个 Intent 对 象 除了 可 以 包含 以 上 的 重要 信息 之 外 ， 还 可 以 存储 一 些 自 定义 的 额外 附加 信息 ， 一 般 来 说 ， 这 些 信 息 是 使 用 键 值 对 (key value) 的 方式 存储 的 。 我 们 可 以 使 用 putExtra 方 法 设置 附加 信 
息 ， 信 息 类 型 非常 丰富 (一 般 还 是 以 字符 串 为 主 ) ; 在 接收 的 时 候 使 用 getExtras 方 法 获取 。 


6. 标 志 (Flags) 


除了 上 面 提 到 的 几 个 功能 属性 ， 消 息 基 类 中 还 定义 了 一 系列 特殊 的 消息 行为 属性 (也 就 是 标志 ) ， 用 于 指示 Android 系 统 如 何 去 启 动 Activity 以 及 启动 之 后 如 何 处 理 。 关 于 标志 (Flags) 的 使 用 我 们 还 
会 在 2.3.4 节 中 介绍 。 
在 Android 应 用 中 ， 消 息 (Intent) 的 使 用 方式 通常 有 两 种 ， 一 是 显 式 消息 (Explicit Intent) ， 另 一 个 则 是 隐 式 消息 (Implicit Intent) 。 显 式 消息 的 使 用 比较 简单 ， 只 需要 在 Intent 中 指定 目标 组 件 


名 称 (也 就 是 前 面 提 到 的 ComponentName 属 性 ) 即 可 ， 一 般 用 于 目标 Activity 比 较 明确 的 情形 。 比 如 在 一 个 固定 流程 中 ， 我 们 需要 从 一 个 Activity 跳 转 到 另 一 个 ， 那 么 我 们 就 会 使 用 显 式 的 消息 。 而 隐 式 消 
息 则 比较 复杂 一 点 ， 它 需要 通过 消息 过 滤器 (IntentFilter) 来 处 理 ， 一 般 用 于 目的 性 不 是 那么 明确 的 情形 ， 比 如 应 用 中 的 某 个 功能 需要 往 目的 地 发 送 消息 ， 但 是 我 们 却 不 确定 要 使 用 短信 发 送 还 是 微 博 发 
送 ， 那 么 这 个 时 候 就 应 该 使 用 隐 性 消息 来 处 理 了 。 下 面 是 一 个 典型 的 消息 过 滤器 的 配置 范例 ， 如 代码 清单 2-2 所 示 。 


代码 清单 ”2-2 


<activityhttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
<intent-filter> 
<action android:name="android.intent.action.SEND" /> 
«category android:name="android. intent .category.DEFAULT" /> 
<data android:scheme="content" android:mimeType="image/*" /> 
</intent-filter> 


</activity> 
我 们 看 到 ， 配 置 消息 过 滤器 使 用 的 是 标签 ， 一 般 需 要 包含 三 个 要 素 : action、category 以 及 data。 其 中 ，action 是 必需 的 ，category 一 般 也 是 需要 的 ， 而 data 则 人 允许 没有 设置 。 接 下 来 ， 我 们 学 习 一 下 
这 几 个 要 素 的 使 用 方法 。 


- <action/>: 在 Android 应 用 中 ， 一 般 会 通过 <action/> 元 素来 匹配 消息 (Intent) ， 如 果 找 到 Action 就 表明 匹配 成 功 ， 否 则 就 是 还 没 找到 目标 。 需 要 注意 的 是 ， 如 果 消 息 过 滤器 没有 指定 <action/> 元 


素 ， 那 么 此 消息 只 能 被 显 式 消息 匹配 上 ， 不 能 匹配 任何 的 隐 式 消息 ; 相反 ， 当 消息 没有 指定 目标 组 件 名 称 时 ， 可 以 匹配 含有 任何 包含 <action/> 的 消息 过 滤器 ， 但 不 能 匹配 没有 指定 <action/> 信 息 的 消息 过 小 


: <category/>: <category/> 元 素 用 于 标注 消息 的 类 别 。 值 得 注意 的 是 ， 假 如 我 们 使 用 <category/> 元 素来 标识 消息 类 别 ， 系 统 在 调用 Context.startActivity 方 法 或 者 Context.startActivityForResult 方 法 时 都 
会 自动 加 上 DEFAULT 类 别 。 因 此 ， 除 了 Intent 已 经 指定 为 Intent,.ACTION_MAIN 以 外 ， 我 们 还 必须 指定 <category/> 为 android.intent.category.DEFAULT， 和 否则 该 消息 将 不 会 被 匹配 到 。 另 外 ， 对 于 Setrvice 和 
BroadcastReceiver， 如 果 Intent 中 没有 指定 <category/> ， 那 么 在 其 消息 过 滤器 中 也 不 必 指 定 。 

: «data/»: 通过 data 字 段 来 匹配 消息 相对 来 讲 比较 复杂 ， 通 常 的 data 字 段 包含 uri、scheme (content, file, http) 和 type (mimeType) 几 种 字段 。 对 于 Intent 来 说 ， 我 们 可 以 使 用 setData 和 setType 方 法 来 设 


置 ， 对 于 IntentFilter 来 讲 ， 则 可 以 通过 android: schemeFeandroid: mimeType 属 性 分 别 来 指定 ， 使 用 范例 如 代码 清单 2-3 所 示 。 


代码 清单 2-3 


<activity http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
«intent-filter» 
«action android:name-"android.intent.action.SEND" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«data android:scheme-"file" android:mimeType-"image/*" /> 
«/intent-filter» 
</activity> 


以 上 的 配置 表明 该 Activity 可 以 发 送 图 片 ， 而 且 内 容 必须 是 单独 的 一 个 文件 ， 也 就 是 说 ， 该 文件 的 URI 路 径 必须 是 以 “file: //” 开 头 的。 当然 ， 如 果 我 们 把 这 里 的 “android: scheme" K 


PË "content" 的 话 ， 则 表明 该 图 片 内 容 必 须 是 由 ContentProvider 提 供 的 ， 即 URI 必 须 是 以 “content: // ”开头 的 。 


至 此 ， 我 们 已 经 介绍 了 消息 (Intent) 和 消息 过 滤器 (IntentFilter) 的 基本 概念 和 用 法 。 我 们 必须 清楚 的 是 ， 消 息 分 为 显 式 消息 和 隐 式 消息 两 种 ， 而 消息 过 滤器 一 般 是 提供 给 隐 式 消息 使 用 的 。 
Android 消 息 过 滤器 的 过 滤 规 则 比较 严格 ， 只 要 我 们 申明 了 除了 默认 值 (DEFAULT) 之 外 的 action、category 和 data， 那 么 ， 只 有 当 对 应 消息 对 象 的 动作 (action) 、 类 别 (category) 和 数据 类 型 


(data) 同时 符合 消息 过 滤器 的 配置 时 才 会 被 考虑 。 关 于 <intent-filter/> 标 签 的 具体 使 用 方法 ， 我 们 将 会 在 本 书 7.2.4 节 中 结合 实例 进行 讲解 。 


2.3.3 视图 (View) 


框架 中 最 重要 的 组 成 部 分 之 一 。 我 们 在 Activity 中 展示 或 者 操作 的 几乎 所 有 控件 都 属于 View。 


视图 (View) 系统 主管 Android 应 用 的 界面 外 观 显示 ， 因 此 也 称 作 Android UI 系统 ， 是 Android 应 
Android 应 用 框架 的 View System 包 含 View 和 ViewGroup 两 类 基础 组 件 。 下 面 我 们 来 理解 一 下 Android 视 图 系统 的 层次 结构 ， 如 图 2-3 所 示 。 


View | View View 


图 2-3 Android 视图 系统 的 层次 结构 


E (div) 。 接 下 来 ， 


视图 类 (View) 是 所 有 视图 (UI) 控件 (包括 ViewGroup) 的 基 类 。 视 图 组 (ViewGroup) 则 类 似 于 集合 ， 一 个 视图 组 可 以 包含 多 个 ViewGroup 和 View， 类 似 于 Html 标 签 中 的 
我 们 再 来 看 看 View 中 会 经 常 使 用 的 一 些 UI 控 件 ( 见 表 2-3) ， 你 也 可 以 在 Android SDK 参 考 文档 (Reference) 中 的 android.widget 包 下 找到 它们 。 


D 


从 表 2-3 中 可 以 看 出 ，Android 应 用 框架 为 我 们 提供 了 非常 丰富 的 视图 控件 ， 从 某 种 程度 上 来 说 ，Android 应 用 的 界面 是 通过 各 种 各 样 的 视图 控件 组 合 起 来 的 。 至 于 这 些 视图 控件 的 具体 用 法 ， 我 们 将 在 
第 7 章 中 结合 项 目 实例 进行 介绍 。 


2-3 ”Android 主 要 UI 控件 


主要 控件 
Button 
CheckBox 
EditText 
Gallery 
GridView 
ImageButton 
Image View 


LinearLayout 


ListPopup Window 


ListView 
PopupMenu 
Popup Window 
ProgressBar 
RadioButton 
RelativeLayout 
Scroll View 
TableLayout 
TextView 


Toast 


编辑 框 控件 
图 片 集 控件 
格子 显示 控件 
图 片 按 钮 

图 片 控件 
线性 布局 
弹出 式 多 选 杠 
列表 控件 
弹出 菜单 
弹出 窗口 
进度 条 控件 
单 选 框 控 件 
绝对 定位 布局 
滚动 式 列表 
表格 布局 
文本 框 

弹出 提示 框 


本 节 只 是 从 应 用 程序 框架 组 成 部 分 的 角度 简单 地 介绍 了 Android UI 系统 的 概念 ， 关 于 


234 任务 (Task) 


本 节 介 绍 Android 任 务 (Task) 的 概念 。 区 别 于 以 上 介绍 的 活动 、 消 息 和 视图 这 几 个 要 点 ， 任 务 的 概念 显得 比较 抽象 ， 


Android 应 用 框架 的 关键 。 


首先 ， 我 们 来 认识 一 人 Android 系 统 中 的 任务 是 如 何 运行 的 。 简 单 来 说， 当 我 们 在 手机 的 应 
涉及 多 个 应 用 中 不 同 Activity 的 界面 ， 而 这 些 Activity 的 运行 状态 都 会 被 存储 到 Task 的 Activity 堆 栈 (Activity Stack) 中 去 。 和 


一 个 常见 任务 中 Activity 堆 栈 的 变化 情况 。 


FUI 系 统 的 更 多 知识 以 及 UI 控件 的 


我 们 在 日 常 编码 过 程 中 也 不 


体 用 法 ， 我 们 将 在 本 章 2.7 节 中 更 系统 地 介绍 。 


接 接触 到 ， 但 是 ， 理 解 任务 却 是 理解 整个 


列表 (Application Launcher) 中 点 击 某 个 应 用 图 标的 时 候 ， 一 个 新 的 Task 就 启动 了 ， 后 面 的 操作 可 能 会 
他 的 堆栈 一 样 ，Activity 堆 栈 采 用 的 是 “后 进 先 出 ”的 规则 。 图 2-4 展 示 就 是 


每 次 启动 一 个 新 的 Activity， 其 都 会 被 压 入 (push) 到 Activity 堆 栈 的 顶部 ， 而 每 次 按 “BACK” 键 ， 当 前 的 Activity 就 会 被 弹出 (pop) Activity 堆 栈 ; 另外 ， 如 果 按 了 “HOME” 键 的 话 ， 该 Task 会 失 


去 焦点 并 被 保存 在 内 存 中 ; 而 一 旦 重新 启动 ，Task 会 自动 读 出 并 显示 上 次 所 在 的 Activity 的 界面 。 那 么 ， 从 一 个 应 用 进入 另 一 个 应 用 的 情况 是 怎样 呢 》 比 如 ， 应 用 中 需要 配置 一 些 系统 设 


考虑 一 下 多 任务 切换 的 情况 了 ， 如 图 2-5 所 示 。 
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图 2-4 单 任务 模式 中 Activity 堆 栈 的 变化 


， 那 么 我 们 就 需要 
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25 多 任务 模式 中 Activity 堆 栈 的 变化 


我 们 假设 Task A 是 应 用 A 的 任务 ， 也 是 我 们 所 在 的 任务 ， 当 运行 到 Activity 3 的 时 候 我 们 按 了 “Home” 键 ， 于 是 Task A 中 的 所 有 Activity 就 都 被 停止 了 ， 同 时 Task A 暂时 退 居 到 后 台 (Background) ; 
这 时 ,我 们 点 击 应 用 B 的 图 标 激活 了 Task B， 于 是 Task B 就 被 推 到 了 前 台 (Foreground) ， 并 展示 出 最 上 层 的 Activity Z; 当然 ， 我 们 还 可 以 用 类 似 的 操作 把 Task A 激活 并 放置 到 前 台 进 行 操作 。 以 上 也 是 
我 们 使 用 Android 系 统 最 经 常 使 用 的 行为 操作 ， 大 家 可 以 结合 实际 情况 好 好 理解 一 下 。 


以 上 的 策略 已 经 可 以 满足 大 部 分 Android 应 用 的 需求 。 此 外 ，Android 还 提供 了 一 些 其 他 的 策略 来 满足 一 些 特殊 的 需求 。 比 较 常见 的 ， 如 我 们 可 以 在 Android 基 础 配置 文件 (Menifest File) 中 使 
<activity/> 元 素 的 launchMode 属 性 来 控制 Activity 在 任务 中 的 行为 特征 。launchMode 有 以 下 四 种 模式 可 供 选择 。 


- Standard 模 式 : Standard 模 式 为 默认 模式 ， 无 论 是 打开 一 个 新 的 Activity， 还 是 接收 Intent 消 息 ， 系 统 都 会 为 这 个 Activity 创 建 一 个 新 的 实例 (instance) ; 每 个 Activity 都 可 以 被 实例 化 多 次 ， 并 且 每 个 任 
务 都 可 以 包含 多 个 实例 。 此 模式 最 常用 ,但 是 其 缺点 就 是 太 耗 费 系 统 资源 。 


: singleTop 模 式 : 该 模式 下 的 行为 和 Standard 模 式 下 的 行为 基本 相同 ， 如 果 该 Activity 正 好 在 运行 状态 (也 就 是 在 Activity 堆 栈 的 顶部 ) ， 那 么 其 接收 Intent 消 息 就 不 需要 重新 创建 实例 ， 而 是 通过 该 类 的 
onNewIntent () 方法 来 处 理 接收 到 的 消息 。 这 种 处 理 方式 在 一 定 程度 上 会 减少 一 些 资源 浪费 。 


: singleTask 模 式 : 此 模式 保证 该 Activity 在 任务 中 只 会 有 一 个 实例 ， 并 且 必 须 存在 于 该 Task 的 根 元 素 ( 即 栈 底 ) 。 此 模式 比较 节省 资源 ， 手 机 浏览 器 使 用 的 就 是 这 种 模式 。 
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: singlelnstance 模 式 : 此 模式 与 singleTask 模 式 类 似 ， 不 同 之 处 是 该 模式 保证 Activity 独 占 一 个 Task， 其 他 的 Activity 都 不 能 存在 于 该 任务 的 Activity 堆 栈 中 。 当 然 ，Activity 接 收 Intent 消 息 


onNewIntent 方 法 实现 。 


此 外 ， 我 们 还 可 以 通过 设置 Intent 消 息 的 flag 标 志 来 主动 改变 Activity 的 调用 方式 ， 比 较 常 见 的 flag 如 下 。 


: FLAG ACTIVITY NEW TASK: 在 新 的 Task 中 启动 目标 Activity， 表 现行 为 和 前 面 提 到 的 singleTask 模 式 下 的 行为 一 样 。 


: FLAG ACTIVITY SINGLE TOP: 如 果 目 标 Activity 正 好 位 于 堆栈 的 顶部 ， 则 系统 不 用 新 建 Activity 的 实例 并 使 用 onNewIntent () 方法 来 处 理 接 收 到 的 消息 。 表 现行 为 和 前 面 提 到 的 singleTop 模 式 下 的 行 
为 一 样 。 


: FLAG ACTIVITY CLEAR TOP: 如 果 目 标 Activity 的 运行 实例 已 经 存在 ， 使 用 此 方法 系统 将 会 清除 目标 Activity 所 处 的 堆栈 上 面 的 所 有 Activity 实 例 。 


= 


需要 注意 的 是 ， 官 方 文档 中 建议 多 使 用 默认 的 Task 行 为 模式 ， 因 为 该 模式 比较 简单 也 易于 调试 。 对 于 一 些 特殊 的 需求 ， 如 果 需 要 使 用 到 其 他 模式 的 话 ， 需 要 模拟 不 同 的 情况 多 进行 一 些 测试 ， 以 防止 在 
一 些 特殊 情况 下 出 现 不 符合 预期 的 情况 。 当 然 ， 说 名 实话， 目前 主流 移动 设备 上 的 Android 版 本 都 还 比较 旧 ， 对 多 任务 管理 的 支持 和 体现 还 不 够 明显 ， 不 过 ， 我 们 应 该 可 以 在 Android 最 新 版 本 (如 Android 
4.0) 里 看 到 对 系统 任务 管理 功能 的 加 强 。 


2.4 Android 系 统 四 大 组 件 


之 前 我 们 已 经 学 习 了 Android 应 用 框架 的 四 大 核心 要 点 ， 对 Android 的 应 用 框架 有 了 一 个 总 体 性 的 了 解 ， 接 下 来 我 们 要 学 习 Android 应 用 程序 中 的 四 个 重要 组 成 部 分 ， 也 就 是 我 们 一 般 所 说 的 “应 用 组 
件 ”。 在 前 面 讲解 四 大 核心 要 点 的 篇 幅 中 ， 我 们 曾经 提 到 了 控件 (View 控 件 ) 的 概念 ， 现 在 我 们 再 来 学 习 一 下 Android 应 用 框架 中 的 组 件 的 概念 。 那 么 何谓 组 件 呢 ? 顾名思义 ， 组 件 当然 要 比 控件 复杂 ， 简 
而 言 之 ， 组 件 是 用 于 工业 化 组 装 的 部 件 。 要 达到 组 件 的 标准 ， 必 须 符合 三 个 要 求 ， 以 下 我 们 结合 Android 应 用 框架 讨论 如 下 。 


1. 有 统一 标准 


这 点 应 该 是 形成 组 件 的 前 提 条 件 ， 试 问 ， 组 件 如 果 没 有 标准 ， 如 何 组 装 ?在 这 点 上 ，Android 应 用 框架 中 定义 了 很 多 标准 接口 ， 满 足 了 组 件 间 的 各 种 接口 需求 ; 换 一 种 说 法 ， 整 合 Android 系 统 都 是 按照 
接口 规范 设计 出 来 的 。 


2. 可 独立 部 署 


组 件 应 该 是 独立 的 ， 每 个 组 件 都 有 自 成 一 套 的 功能 体系 ， 否 则 就 没有 形成 组 件 的 必要 。 比 如 每 个 Activity 都 是 可 以 独立 构造 的 ， 使 用 Activity 组 件 ， 我 们 可 以 完成 一 个 包含 许多 复杂 功能 的 界面 ; 而 使 用 
Service， 我 们 可 以 操作 一 个 独立 的 后 台 进 程 等 。 


3. 可 组 装 整合 


可 组 装 是 组 件 最 重要 的 特性 ， 一 个 完整 的 Android 应 用 必然 是 若干 个 系统 组 件 构成 的 ， 这 就 要 求 组 件 必须 是 能 组 装 在 一 起 的 ， 至 于 如 何 组 装 ， 我 们 会 在 后 面 的 章节 中 结合 实例 进行 介绍 。 


通常 来 讲 ，Android 应 用 框架 中 包含 了 四 大 组 件 : 活动 (Activity) 、 服 务 (Service) 、 广 播 接收 器 (Broadcast Receiver) 和 内 容 提供 者 (Content Provider) 。 这 四 大 组 件 除 了 具有 前 面 所 提 到 的 三 
个 特点 之 外 ， 还 有 着 相同 的 显著 特点 ， 那 就 是 它们 都 可 以 在 Android 的 基础 配置 文件 ， 即 AndroidManifest.xml 中 进行 配置 。 下 面 我 们 就 来 学 习 Android 系 统 四 大 组 件 的 基本 概念 和 使 用 方法 。 


2.4.1 活动 (Activity) 


在 2.3.1 节 中 ， 我 们 已 经 介绍 了 Android 活 动 (Activity) 的 生命 周期 以 及 基本 行为 ， 大 家 应 该 对 Activity 的 概念 有 了 一 定 的 了 解 。 此 外 ，Activity 同 时 还 是 Android 系 统 四 大 组 件 中 的 一 员 ， 因 此 ， 本 节 将 
着 重 介绍 Activity 作 为 组 件 的 一 般 声明 方法 。 


说 到 Activity 的 声明 方法 ， 我 们 必须 先 了 解 Android 全 局 配置 文件 AndroidManifest.xml 的 基础 知识 。 每 个 Android 应 用 项 目 都 会 有 自己 的 全 局 配置 文件 ， 该 文件 包含 了 应 用 的 系统 常量 、 系 统 权 限 以 及 
所 含 组 件 等 配置 信息 。 配 置 使 用 范例 如 代码 清单 2-4 所 示 。 


代码 清单 ”2-4 


«manifest http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
«application http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
«activity android:name-"com.app.android.HelloActivity" ui 
android:theme-"Qandroid:style/Theme.NoTitleBar.Fullscreen" 
android:screenOrientation-"landscape"» 
<intent-filter> 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
«/intent-filter» 
<intent-filter> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</intent-filter> 
</activity> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</application> 
<uses-permission http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/.../> 
«uses-permission http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/.../> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</manifest> 


从 上 述 配置 使 用 范例 中 ， 我 们 可 以 看 到 在 AndroidManifest.xm| 配 置 文件 范例 的 根 元素 <manifest/> 下 面 有 两 种 标签 ， 即 <application/> 和 <Uuses-permission/> 元 素 。 前 者 是 应 用 配置 的 根 元 素 ， 而 
后 者 则 用 于 配置 应 用 的 权限 。 这 里 顺便 说 一 下 ， 每 个 Android 应 用 都 必须 事先 声明 应 用 需要 的 权限 ， 比 如 是 否 需要 网 络 、 是 否 需要 使 用 摄像 头 或 者 是 否 需要 打开 卫星 定位 (GPS) 等 。 而 用 户 在 安装 该 应 用 
之 前 ， 系 统 会 先 提 示 用 户 是 否 允许 该 应 用 使 用 这 些 权限 ， 如 果 用 户 觉 得 应 用 不 安全 便 可 以 选择 不 安装 ， 这 在 一 定 程度 上 也 提高 了 Android 系 统 的 安全 性 。 


另外 ， 我 们 还 可 以 看 到 ， 在 以 上 配制 文件 中 的 <application/> 元 素 里 面 含有 一 个 或 者 若干 个 <activity/ > 元素， 这 个 就 是 我 们 需要 重点 了 解 的 Activity 标 签 了 。 首 先 ， 我 们 来 看 一 下 该 标签 内 部 的 一 些 党 
的 配置 选项 。 


- android: name: 表示 该 Activity 对 应 的 类 的 名 称 ， 在 代码 清单 2-4 中 ， 我 们 就 定义 了 一 个 Activity， 它 的 具体 类 包 名 就 是 “com.ap android. HelloActivity” o 


: android: theme: 表示 Activity 所 使 用 的 主题 ， 在 Android 系 统 中 是 允许 我 们 自 定义 主题 的 (这 部 分 的 内 容 我 们 在 后 面 章节 的 实例 中 会 介绍 到 ) ， 在 代码 清单 2-4 中 ， 使 用 的 是 默认 主题 “@android: 


style/Theme.NoTitleBar.Fullscreen”， 也 就 是 全 屏 模 式 。 
- android: launchMode: Activity 的 行为 模式 ， 之 前 在 2.3.4 节 中 介绍 过 该 标签 的 4 种 选项 ， 即 与 任务 行为 有 关 的 Standard、 singleTop、singleTask 以 及 singleInstance。 


- android: screenOrientation: 表示 屏幕 的 方向 ， 在 代码 清单 2-4 中 ，landscape 表 示 的 是 该 Activity 是 横 屏 显示 的 ， 如 果 改 成 portrait 的 话 ， 则 就 变 成 竖 屏 显示 。 


当然 ，Activity 标 签 可 配置 的 选项 远 不 止 以 上 这 些 ， 更 详细 的 使 用 说 明 可 以 参考 7.1.2 节 的 内 容 ， 使 用 范例 可 参考 代码 清单 7-11。 此 外 ， 从 上 面 的 配制 文件 中 我 们 还 可 以 看 到 不 止 一 个 <intent-filter> 元 
素 。 关 于 这 点 ， 实 际 上 ， 前 面 我 们 已 经 介绍 过 消息 过 滤器 的 用 法 ， 如 果 大 家 有 疑问 的 话 ， 可 以 参考 2.3.2 节 中 与 消息 (Intent) 相关 的 内 容 。 


另外 ，Activity 在 应 用 开发 中 被 用 做 控制 界面 的 逻辑 ， 也 就 是 MVC 中 的 Controller 控 制 器 ， 关 于 Android 应 用 中 MVC 的 概念 可 参考 5.2.3 节 中 的 内 容 。 开 发 者 可 以 根据 需要 ， 在 Activity 的 生命 周期 方法 中 
添加 不 同 的 逻辑 来 控制 对 应 应 用 界面 的 显示 、 动 作 和 响应 等 ， 而 Activity 类 的 具体 用 法 和 代码 示例 我 们 可 以 在 本 书 第 7 章 的 “ 微 博 实例 ”代码 中 学 习 到 。 


24.2 服务 (Service) 


Android 系 统 中 的 Service 服 务 组 件 和 Windows 系 统 中 的 后 台 服 务 有 点 类 似 ， 这 个 概念 应 该 很 容易 理解 ， 比 如 ， 我 们 在 退出 某 些 聊天 软件 之 后 还 是 可 以 接收 到 好 友 发 来 的 消息 ， 就 是 使 用 Android 服 务 组 
件 来 实现 的 。 此 外 ， 如 果 需 要 在 应 用 后 台 运 行 某 些 程序 ，Service 服 务 组 件 也 绝对 是 最 佳 的 选择 。 另 外 ， 值 得 注意 的 是 ，Service 和 之 前 的 Activity 一 样 ， 也 有 自己 的 生命 周期 ， 但 是 ，Service 的 生命 周期 相对 
简单 一 些 ， 如 图 2-6 所 示 。 


从 图 2-6 中 我 们 可 以 看 出 Android 服 务 (Service) 主要 有 以 下 两 种 运行 模式 。 


: 独立 运行 模式 : 我 们 一 般 通 过 “startService () ”方法 来 启动 一 个 独立 的 服务 ， 在 这 种 模式 下 ， 该 服务 不 会 返回 任何 信息 给 启动 它 的 进程 ， 进 程 的 动作 结束 后 会 自动 结束 。 比 如 ， 浏 览 器 下 载 就 属于 独 


立 服 务 。 


: 绑 定 运行 模式 : 与 独立 服务 不 同 ， 绑 定 服务 是 与 启动 它 的 应 用 绑 定 在 一 起 的 ， 当 该 应 用 结束 的 时 候 ， 绑 定 服务 也 会 停止 。 另 外 ， 这 种 服务 可 以 和 应 用 中 的 其 他 模块 进行 信息 交互 ， 甚 至 进行 进程 通信 
(IPC) 。 


onCreate() 


onStartCommand() 


. Service is running 
(clients are 
bound to it) 


Active 
Lifetime 
All clients unbind by calling | 
unbindService() 


The service is stopped 
by itself or a client 


onUnbind() 


Unbounded Bounded 


图 2-6 Service 生 命 周期 


与 Activity 类 似 ，onCreate 和 onDestroy 分 别 是 Android 服 务 创建 和 销毁 过 程 中 的 回调 方法 。 与 独立 运行 模式 相 比 ， 绑 定 运行 模式 中 多 出 来 onBind 和 onUnbind 两 个 函数 ， 分 别 是 服务 绑 定 和 解 绑 过 程 的 
回调 方法 。 在 Android 应 用 开发 的 时 候 ， 我 们 通常 会 使 用 startService 方 法 来 开启 Service 服 务 。 另 外， 在 应 用 开发 的 时 候 干 万 别 忘 了 我 们 必须 事先 在 全 局 配置 文件 中 进行 如 下 声明 ， 如 代码 清单 2-5 所 示 。 


代码 清单 ”2-5 


«application http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
service android:name-" .HelloService"/» _ 
<activity http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
</activity> 
</application> 


理解 Android 服 务 (Service) 时 要 特别 注意 , 干 万 不 要 盲目 认为 服务 是 一 个 独立 的 进程 或 者 线程 。 实 际 上 ， 它 和 应 用 程序 的 进程 之 间 存 在 着 复杂 的 联系 ， 所 以 如 果 我 们 需要 在 Service 中 做 一 些 耗 时 操作 
的 话 ， 必 须 新 起 一 个 线程 并 使 用 消息 处 理 器 Handler 来 处 理 消息 。 另 外 ，Android 服 务 的 进程 间 通 信 (IPC) 功能 还 涉及 AIDL (Android Interface Definition Language，Android 接 口 定 义 语言 ) S 
的 话 尽管 去 了 解 一 下 。 关 于 Service 的 具体 使 用 实例 ， 大 家 可 以 先 去 看 看 Android SDK 中 API Demos 里 面 的 RemoteService 实 现 ， 本 书后 面 的 实例 中 我 们 也 会 穿插 介绍 。 


小 贴 士 : Handler 是 消息 处 理 器 ， 用 于 接受 子 线程 的 消息 进行 处 理 并 配合 主线 程 更 新 UI 界面 ， 具 体内 容 可 参考 5.2.2 节 中 界面 基础 类 BaseUi 的 相关 内 容 。 


在 Android 系 统 中 ，Service 服 务 类 的 使 用 方法 比较 简单 ， 执 行 Service 对 象 的 start 方 法 就 可 以 开启 一 个 服务 。 实 际 上 ， 第 7 章 的 “ 微 博 实例 ”中 也 有 与 Service 服 务 相关 的 代码 实例 ， 请 参考 7.5.4 节 。 


24.3 ”广播 接收 器 (Broadcast Receiver) 


广播 接收 器 (Broadcast Receiver) 是 Android 系 统 的 重要 组 件 之 一 ， 可 以 用 来 接收 其 他 应 用 发 出 来 的 广播 ， 这 样 不 仅 增强 了 Android 系 统 的 交互 性 ， 而 且 能 在 一 定 程度 上 提高 用 户 的 操作 体验 。 比 如 ， 
你 在 把 玩 应 用 或 者 游戏 的 同时 也 可 以 随时 接收 一 条 短信 或 者 一 个 电话 ， 或 者 你 在 打开 网 页 的 同时 还 可 以 接收 短信 验证 码 等 。 


广播 接收 器 的 使 用 也 很 简单 ， 和 其 他 组 件 的 步骤 一 样 : 先 声明 ， 再 调用 。 代 码 清单 2-6 就 是 一 个 声明 广播 接收 器 的 例子 。 


代码 清单 2-6 


«application http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
«receiver android:name-".HelloReceiver"» X 
<intent-filter> 
<action android:name="com.app.basicreceiver.helloreceiver"/> 
</intent-filter> 
</receiver> 
<activity http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
</activity> m 
«/application» 


这 里 我 们 定义 了 一 个 名 为 HelloReceiver 的 广播 接收 器 。 这 个 类 里 面 只 有 一 个 onReceive 方 法 ， 里 面 我 们 可 以 定义 需要 的 操作 。 使 用 的 时 候 ， 我 们 可 以 在 Activity 中 直接 使 用 sendBroadcast 方 法 来 发 送 广 
播 消息 ， 这 样 HelloReceiver 就 会 接收 到 我 们 发 送 的 信息 并 进行 相应 的 处 理 。 这 里 需要 注意 的 是 ， 广 播 接收 器 也 是 在 应 用 主线 程 里 面 的， 所 以 我 们 不 能 在 这 里 做 一 些 耗 时 的 操作 ， 如 果 需 要 的 话 ， 可 以 新 开 线 
程 来 解决 。 发 送 广播 消息 的 范例 如 代码 清单 2-7 所 示 。 


代码 清单 2-7 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
Intent intent = new Intent ("com.app.basicreceiver.hello"); 

sendBroadcast (intent); 

http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


而 接收 消息 的 使 用 范例 ， 也 就 是 广播 接收 器 类 HelloReceiver 的 逻辑 实现 ， 我 们 可 以 参考 代码 清单 2-8。 


代码 清单 2-8 


public class HelloReceiver extends BroadcastReceiver { 
GOverride 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
Toast.makeText (context, "Receive Action : " + action, 1000).show(); 


) 


另外 ， 我 们 需要 了 解 ，Android 系 统 中 的 广播 消息 是 有 等 级 的 ， 可 分 为 普通 广播 (Normal Broadcasts) 和 有 序 广播 (Ordered Broadcasts) 两 种 。 前 者 是 完全 异步 的 ， 可 以 被 所 有 的 接收 者 接收 到 ， 
而 且 接 收 者 无 法 终止 广播 的 传播 ; 而 有 序 广 播 则 是 按照 接收 者 的 优先 级 别 被 依次 接收 到 。 优 先 级 别 取 决 于 intent-filter 元 素 的 android: priority 属 性 ， 数 越 大 ， 优 先 级 越 高 。 至 于 使 用 ， 我 们 通常 会 在 
onResume 事 件 中 通过 registerReceiver 进 行 注册 ， 在 onPause 等 事件 中 注销 ， 这 种 方式 使 其 能 够 在 运行 期 间 保持 对 相关 事件 的 关注 。 常 见 的 广播 事件 有 : 短信 广播 、 电 量 通知 广播 等 。 


244 内 容 提 供 者 (Content Provider) 


在 Android 应 用 中 ， 我 们 可 以 使 用 显 式 消息 (Explicit Intent) 来 直接 访问 
内 容 提供 者 (Content Provider) 。 


到 另外 一 种 组 件 ， 这 就 是 所 谓 的 


他 应 用 的 Activity， 但 是 这 仅 限于 Activity 的 范畴 ; 如 果 需 要 使 用 其 他 应 用 的 数据 ， 还 需 


顾名思义 ， 内 容 提供 者 就 是 Android 应 用 框架 提供 的 应 用 之 间 的 数据 提供 和 交换 方案 ， 它 为 所 有 的 应 用 开 了 一 扇 窗 ， 应 用 可 以 使 用 它 对 外 提供 数据 。 每 个 Content Provider 类 都 使 用 URI (Universal 
Resource Identifier， 通 用 资源 标识 符 ) 作为 独立 的 标识 ， 格 式 如 : content: //xxx。 其 格式 类 似 于 REST， 但 是 比 REST 更 灵活 ， 因 为 在 调用 接口 的 时 候 还 可 以 添加 Projection、Selection、OrderBy 等 参 
数 ， 结 果 以 Cursor 的 模式 返回 。Content Provider 的 声明 写法 非常 简单 ， 示 例 可 参考 代码 清单 2-9。 


代码 清单 2-9 


<application http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...> 
<provider android:name="com.app.android.HelloProvider" T 
android:authorities="com.app.android.HelloProvider"/> 
<activity http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</activity> T 
</application> 


关于 Content provider 的 类 实现 ， 我 们 只 需要 继承 Contentprovider 接 口 并 实现 其 中 的 抽象 方法 即 可 ， 这 几 个 方法 有 点 类 似 于 数据 操作 对 象 DAO 的 抽象 方法 ， 其 中 包括 insert、delete、query 和 
update 这 些 常见 的 “增删 查 改 ”的 接口 方法 。 对 于 具体 的 数据 存储 来 说 ， 一 般 会 使 用 Android 的 内 置 数据 库 SQLite， 当 然 也 可 以 采用 文件 或 者 其 他 形式 的 混合 数据 来 实现 。 关 于 Android 系 统 中 的 数据 存储 
我 们 会 在 2.6 节 中 介绍 。 


我 们 在 使 用 上 述 四 大 组 件 的 时 候 还 需要 注意 的 是 : 实际 上 ，Service 和 Content Provider 都 可 用 于 IPC (Inter-Process Communication， 进 程 间 通 信 ) ， 也 就 是 在 多 个 应 用 之 间 进 行 数据 交换 。Service 
可 以 是 异步 的 ， 而 Content Provider 则 是 同步 的 。 在 某 些 情况 下 ， 在 设计 的 时 候 我 们 要 考虑 到 性 能 问题 。 当 然 ，Android 也 提供 了 一 个 AsyncQueryHandler 帮 助 异步 访问 Content Provider。 关 于 以 上 四 大 
组 件 的 具体 使 用 ， 我 们 会 在 后 面 的 章节 中 穿插 介绍 。 


另外 ,与 Content Provider 配 合 使 用 的 还 有 Content Resolver， 即 内 容 处 理 器 。 前 面 也 提 到 了 Content Provider 是 以 数据 库 接口 的 方式 将 数据 提供 出 去 ， 那 么 Content Resolver 也 将 采用 类 似 的 数据 库 
操作 来 从 Content Provider 中 获取 数据 ， 而 获取 数据 就 需要 使 用 query 接 口 。 和 Content Provider 类 似 ，Content Resolver 也 需要 使 用 URI 的 方式 来 获取 对 应 的 内 容 ， 其 使 用 范例 可 参考 7.3.2 节 中 提 到 的 
HttpUtil 类 的 相关 代码 (代码 清单 7-34) 。 


2.5 Android 上 下 文 


大 家 对 上 下 文 (Context) 的 概念 并 不 陌生 ， 在 软件 开发 领域 ， 它 主要 用 于 存储 进程 或 应 用 运行 时 
对 于 Android 应 用 来 说， 上 下 文 是 非常 重要 的 ， 这 部 分 的 内 容 在 Android 应 和 


在 Android 应 用 框架 中 ， 根 据 作 用 域 的 不 同 ， 可 以 把 上 下 文 分 为 两 种 ， 一 种 是 Activity 界 


绍 这 两 种 上 下 文 的 概念 和 使 用 。 


2.5.1 界面 上 下 文 (Activity Context) 


界面 上 下 文 (Activity Context) 在 应 用 界面 (Activity) 启动 的 时 候 被 创建 ， 主 要 用 于 保存 对 当前 界面 资源 的 引 
到 该 Activity 的 上 下 文 对 象 。 比 如 ， 我 们 需要 在 界面 中 创建 一 个 控件 ， 示 例 代码 如 清单 2-10 所 示 。 


关 的 资源 时 ， 会 需 


代码 清单 2-10 


的 实际 开发 中 也 会 经 常 使 用 到 ， 因 此 本 节 将 会 


。 界 


的 资源 和 对 象 的 引用 ， 此 外 ， 我 们 在 接触 其 他 系统 和 框架 的 时 候 也 经 常会 碰 到 上 下 文 的 概念 。 当 然 ， 
点 介绍 Android 上 下 文 的 相关 知识 ， 为 后 面 实战 编程 打下 一 定 的 基础 。 


的 上 下 文 ， 即 Activity Context; 另 一 种 是 Android 应 用 的 上 下 文 ， 即 Application Context。 下 面 我 们 分 别 介 


上 下 文 在 Activity 界 面 控制 器 类 中 被 使 用 ， 当 我 们 需要 加 载 或 者 访问 Activity 相 


public class TestActivity extends Activity { 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
TextView mTextView = new TextView (this); 
label.setText ("Test Text View"); 
setContentView (mTextView); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
l 


通过 上 面 的 代码 片断 ， 我 们 创建 了 一 个 文本 框 控件 (TextView) ， 并 赋予 该 控件 对 应 界面 控制 器 (TestActivity) 的 上 下 文 对 象 (this) 。 实 际 上 ， 把 界面 控制 器 的 上 下 文 对 象 传递 给 控件 ， 就 意味 着 该 


控件 拥有 一 个 指向 该 界面 对 象 的 引用 ， 可 以 引用 界面 对 象 占有 的 资源 ; 同时 ，Android 界 面 系 统 也 将 该 控件 绑 定 到 该 上 下 文 指向 的 界 


界面 上 下 文 (Activity Context) 的 生命 周期 跟 Activity 界 面 的 是 同步 的 ， 即 当 Activity 被 销毁 的 时 候 ， 其 对 应 的 上 下 文 也 被 销毁 了 ， 同 时 ， 和 该 上 下 文 有 关 的 控件 对 象 也 将 被 销毁 并 
可 以 认为 上 下 文 可 以 用 于 串联 Android 应 用 之 中 的 对 象 和 组 件 ， 在 理解 了 这 点 之 后 ， 在 使 


- getApplicationContext: 获取 当前 应 用 的 上 下 文 对 象 ， 相 关内 容 请 参考 2.5.2 节 。 


盏 对 象 ， 最 终 组 合并 展示 出 来 。 


Is] 
B 


此 ， 我 们 也 


上 下 文 的 时 候 就 不 会 迷惑 了 。 此 外 ，Context 类 中 比较 常用 的 方法 如 下 。 


- getApplicationInfo: 获取 当前 应 用 的 完整 信息 并 存 于 ApplicationInfo 对 象 中 ， 其 中 常用 的 信息 包括 包 名 packageName、 图 标 icon 以 及 权限 permission 等 属性 ， 更 多 属性 可 参考 SDK 中 


android.content.pm.ApplicationInfo 类 的 说 明 。 


: getContentResolver: 获取 ContentResolver 对 象 ， 用 于 查询 所 需 的 Content Provider 提 供 的 信息 ， 更 多 知识 请 参考 2.4.4 节 内 容 。 


: getPackageManager: 获取 PackageManager 对 象 ，PackageManager 的 用 途 比 Application-Info 更 加 广泛 ， 该 类 可 以 从 系统 的 PackageManagetService 中 获取 安装 包 和 运行 进程 的 信息 ， 作 用 于 系统 范围 。 


: getPackageName: 获取 包 名 ， 包 名 (packageName) 可 作为 Android 应 用 的 唯一 标识 。 


: getResources: 获取 应 用 的 资源 对 象 Resources， 该 对 象 提 供 一 系列 的 get 方 法 来 获取 图 形 Drawable、 字 符 囊 String 以 及 视频 Movie 等 资源 。 


: getSharedPreferences: 获取 用 于 持久 化 存储 的 SharedPreferences 对 象 ， 相 关内 容 请 参考 2.6.1 节 。 


: getSystemService: 获取 系统 级 别 服务 的 对 象 ，Android 应 用 框架 为 我 们 提供 了 丰富 的 系统 服务 ，getSystemService 方 法 就 是 用 于 获取 这 些 系 统 服务 对 象 并 运用 到 应 用 开发 中 去 。 表 2-4 中 列 出 了 常用 系 


统 服务 及 其 简单 介绍 ， 大 家 可 以 先 了 解 一 下 。 


表 2-4 Android 常 用 系统 服务 


服务 名 
ACTIVITY SERVICE 
ALARM SERVICE 
CONNECTIVITY SERVICE 
KEYGUARD SERVICE 
LAYOUT INFLATER SERVICE 
LOCATION SERVICE 
NOTIFICATION SERVICE 
POWER SERVICE 
SEARCH SERVICE 
TELEPHONY SERVICE 
VIBRATOR SERVICE 
WIFI SERVICE 
WINDOW SERVICE 


返回 对 象 
ActivityManager 
AlarmManager 
Connectivity 
KeyguardManager 
LayoutInflater 
LocationManager 
NotificationManager 
PowerManager 
SearchManager 
TelephonyManager 
Vibrator 
WifiManager 


WindowManager 


服务 功能 
系统 应 用 程序 管理 
系统 闹钟 服务 
网 络 连接 服务 
键盘 锁 服 务 
获取 Xml 模板 中 View 组 件 服务 
位 置 服务 ， 如 GPS 等 
状态 栏 和 通知 栏 服 务 
系统 电源 管理 
系统 搜索 服务 
系统 电话 服务 
手机 震动 服务 
手机 WIFI 相关 服务 
系统 窗口 管理 


界面 上 下 文 是 Android 应 用 开发 中 最 经 常 被 使 用 的 上 下 文 对 象 ， 应 


2.5.2 应 用 上 下 文 (Application Context) 


应 用 上 下 文 (Application Context) 在 整个 应 用 (Application) 开始 的 时 候 被 创建 ， 


界面 中 几乎 所 有 的 UI 控件 都 需要 用 到 ， 这 一 点 在 实际 运用 的 过 程 中 大 家 会 体会 得 更 深刻 。 


于 保存 对 整个 应 用 资源 的 引 


， 在 程序 中 可 以 通过 界面 上 下 文 的 getApplicationContext 方 法 或 者 


getApplication 方 法 来 获取 。 在 实际 应 用 的 时 候 ， 我 们 通常 会 把 应 用 上 下 文 当做 全 局 对 象 的 引用 来 使 用 。 当 然 ， 对 于 不 同 的 应 用 我 们 会 定义 应 用 对 象 来 使 用 ， 如 代码 清单 2-11 所 示 。 


代码 清单 2-11 


class TestApp extends Application { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
private String status; 2 
public String getStatus()( 
return status; 


} 
public void setStatus (String s){ 
status = s; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


TestApp 应 用 类 继承 自 Application 基 类 ， 定 义 了 自己 的 状态 变量 和 get/set 方 法 ， 可 在 整个 应 用 程序 中 进行 设置 和 获取 。 当 然 ， 我 们 还 需要 在 应 用 程序 的 配置 文件 AndroidManifest.xml 中 进行 配置 ， 如 
代码 清单 2-12 所 示 。 


代码 清单 2-12 


<application android:name=".TestApp" 

android:icon="@drawable/icon" 

android: label="@string/app_name"> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</application> 


配置 完毕 之 后 ， 在 应 用 程序 的 Activity 界 面 中 就 可 以 使 用 getApplicationContext 来 获取 该 应 用 的 上 下 文 对 象 来 完成 所 需 功能 了 ， 使 用 范例 请 参考 代码 清单 2-13。 


代码 清单 2-13 


class TestActivity extends Activity { 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
GOverride 


public void onCreate (Bundle b) { 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
TestApp app = (TestApp) this.getApplicationContext (); 
String status = app.getStatus(); 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


实际 上 ， 在 Android 应 用 框架 中 ，android.app.Activity 类 和 android.app.Application 类 都 是 从 android.content.Context 类 继承 而 来 的 ， 这 也 是 为 什么 可 以 在 Activity 和 Application 中 方便 地 使 用 this 
来 代 蔡 对 应 上 下 文 的 原因 。 当 然 ， 理 解 两 种 Android 上 下 文 的 用 法 在 Android 应 用 编程 中 是 非常 重要 的 ， 因 为 只 有 理解 了 Android 上 下 文才 能 比较 完整 地 理解 Android 应 用 的 运行 环境 ， 进 而 更 好 地 控制 应 
的 运行 状态 。 另 外 ， 我 们 也 会 在 第 7 章 中 通过 实例 来 加 深 大 家 对 Android 上 下 文 用 法 的 理解 。 


2.6 Android 数 据 存储 


前 面 刚 介绍 过 上 下 文 对 象 的 使 用 ， 其 最 重要 的 功能 之 一 ， 就 是 用 于 存储 应 用 运行 期 间 产 生 的 中 间 数 据 。 接 下 来 ， 我 们 来 讨论 Android 应 用 中 持久 化 类 型 数据 的 存储 方案 。 对 于 移动 互联 网 应 用 来 说 ， 我 
们 经 常 把 核心 数据 存储 在 服务 端 ， 也 就 是 我 们 常 说 的 “云端 ”， 但 是 在 实际 项 目 中 也 会 经 常 使 用 到 Android 系 统 内 部 的 数据 存储 方案 ， 接 下 来 让 我 们 认识 一 下 几 种 最 常用 的 数据 存储 方案 。 


2.6.1 应 用 配置 (Shared Preferences) 


在 Android 系 统 中 ， 系 统 配置 (Shared Preferences) 是 一 种 轻 量 级 的 数据 存储 策略 ， 只 能 用 于 存储 key-value 格 式 的 数据 (类 似 于 ini 格 式 ) ， 因 此 这 个 特点 也 决定 了 我 们 不 可 能 在 其 中 存储 其 他 各 种 
复杂 格式 的 数据 。 由 于 系统 配置 使 用 起 来 比较 简单 方便 ， 所 以 我 们 经 常用 它 来 存储 一 些 类 似 于 应 用 配置 形式 的 信息 。 代 码 清单 2-14 就 是 一 个 简单 的 例子 。 


代码 清单 ”2-14 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
settings = getPreferences (Context .MODE PRIVATE); T 
if (settings.getString ("username", null) == null) í 

SharedPreferences.Editor editor = settings.edit(); 

editor.putString("username", "james"); 

editor.commit () ; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


以 上 代码 的 逻辑 很 简单 : AMAR BEE "username" B9(&, ARERR "james" SABA "username" 。 这 里 我 们 重点 分 析 两 点 : 首先 是 关于 Context.MODE_PRIVATE, MODE PRIVATE 
代表 此 时 Shared Preferences 存 储 的 数据 是 仅 供应 用 内 部 访问 的 ， 除 此 之 外 ，Android 系 统 中 还 提供 MODE_WORLD_READABLE 和 MODE WORLD _WRITEABLE 两 种 模式 ， 分 别 用 于 表示 数据 是 否 人 允许 其 
他 应 用 来 读 或 者 写 ; 另外 还 需要 注意 的 一 点 是 ， 我 们 在 操作 数据 的 时 候 必须 使 用 SharedPreferences.Editor 接 口 来 编辑 和 保存 数据 ， 最 后 还 必须 调用 commit 方 法 进行 提交 ， 否 则 数据 将 不 会 被 保存 。 


外 ， 系 统 配置 信息 会 被 存储 在 “/data/data” 下 对 应 的 应 用 包 名 下 的 shared_prefs 目 录 里 ， 一 般 是 以 XML 文件 格式 来 存储 的 。 在 Eclipse 中 ， 我 们 可 以 使 用 DDMS 工 具 (本 章 的 2.10.3 节 会 介绍 ) 打开 
对 应 的 目录 进行 查看 。 


262 ”本 地 文件 (Files) 


将 数据 保存 成 为 文件 应 该 是 所 有 系统 都 会 提供 的 一 种 比较 简单 的 数据 保存 方法 ， 我 们 已 经 知道 Android 系 统 是 基于 Linux 系 统 来 开发 的 ， 而 Linux 系 统 就 是 一 个 文件 系统 ， 很 多 的 数据 都 是 以 文件 形式 存 
在 的 。 与 系统 配置 不 同 ， 文 件 可 存储 的 格式 是 没有 限制 的 ， 所 以 使 用 范围 自然 也 比 系统 配置 广 得 多 ， 除 了 可 用 于 各 种 类 型 文件 的 读 写 ， 我 们 还 经 常用 于 保存 一 些 二 进 制 的 缓存 数据 ， 比 如 图 片 等 。 


在 Android 中 ， 我 们 一 般 使 用 openFileOutput 方 法 来 打开 一 个 文件 ， 此 方法 会 返回 一 个 FilelnputSstream 对 象 ， 然 后 我 们 就 可 以 选择 使 用 合适 的 方法 来 操作 数据 。 比 如 ， 对 于 cfg 或 者 ini 类 型 的 文件 来 
说 ， 我 们 可 以 使 用 Properties 的 load 方 法 来 直接 载 入 ， 对 于 其 他 普通 的 文件 ， 我 们 则 可 以 使 用 InputStreamReader 和 BufferedReader 来 读 取 。 代 码 清单 2-15 就 是 一 个 典型 的 在 Android 系 统 中 读 取 文 件 内 容 
的 例子 。 


代码 清单 2-15 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public String getFileContent (String filePath) { T 
StringBuffer sb = new StringBuffer (); 
FileInputStream stream = null; 
try { 
stream = this.openFileInput (filePath) ; 
BufferedReader br = new BufferedReader (new InputStreamReader (stream, "UTF-8")); 
String line = ""; 
while ((line = br.readLine()) != null) { 
sb.append (line); 


} 
) catch (http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...) ( 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
) finally { = 
if (stream != null) { 
try { 
stream.close(); 
} catch (http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...) { 
http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
} 
] 


return sb.toString(); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


在 上 面 的 代码 中 ， 我 们 实现 了 一 个 名 为 getFileContent 的 方法 ， 用 于 获取 对 应 文件 的 内 容 ; 其 中 就 使 用 了 openFilelnput 来 获取 文件 数据 ， 并 通过 一 系列 的 拼装 ， 最 终 返 回 整个 文件 的 内 容 。 另 外 ， 我 
们 需要 了 解 一 下 ， 在 Android 系 统 中 ， 文 件 一 般 会 存储 到 和 配置 文件 同 级 的 目录 下 ， 只 不 过 目录 名 不 是 shared_prefs， 而 是 files。 更 多 关于 Android 文 件 存储 的 例子 我 们 会 在 本 书 第 7 章 中 进行 详细 介绍 。 


26.3 数据 库 (SQLite) 


关于 数据 库 的 概念 ， 我 相信 大 家 都 已 经 非常 熟悉 了 。Android 系 统 给 我 们 提供 了 一 个 强大 的 文本 数据 库 ， 即 SQLite 数 据 库 。 它 提供 了 与 市 面 上 的 主流 数据 库 (如 MySQL、SQLserver 等 ) 类 似 的 几乎 所 
有 的 功能 ， 包 括 事务 (Transaction) 。 由 于 篇 幅 限制 ， 我 们 不 能 在 这 里 介绍 太 多 关于 SQLite 数 据 库 的 内 容 ， 因 此 ， 如 果 大 家 想 了 解 更 多 信息 请 到 SQLite 的 官方 网 站 (http://www.sqlite.org) 查看 。 


与 之 前 介绍 的 两 种 数据 存储 模式 不 同 ， 数 据 库 的 存储 方式 偏向 于 存 取 的 细节 ， 比 如 ， 我 们 可 以 把 同一 类 型 的 数据 字段 定义 好 ， 并 保存 到 统一 的 数据 表 中 去 ， 进 而 可 以 针对 每 个 数据 进行 更 细节 的 处 理 。 
所 以 ， 如 果 可 能 的 话 ， 尽 量 使 用 数据 库 来 存储 数据 ， 这 样 会 大 大 增强 应 用 的 结构 性 和 扩展 性 。 另 外 ， 我 们 还 经 常 把 SQLite 数 据 库 和 前 面 所 提 到 的 Android 四 大 组 件 之 一 的 “数据 提供 者 ”结合 使 用 ， 因 为 它 
们 对 于 “增删 查 改 ”接口 的 定义 和 使 用 实际 上 是 一 致 的 。 另 外 ， 我 们 在 使 用 的 过 程 中 经 常 通过 继承 SQLiteOpenHelper 类 并 实现 其 中 的 抽象 方法 的 形式 来 构造 基础 的 DB 操作 类 ， 使 用 范例 如 代码 清单 2-16 所 
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代码 清单 2-16 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public class DBHelper extends SQLiteOpenHelper { 
/* 数据 库 配 置 */ 
Private static final int DB VERSION = 1; 
private static final String DB NAME "mydb. db"; 
private static final String DB_TABLE = "mytable"; 
/* 数据 库 初 始 化 和 更 新 SQL */ 
private static final String SQL CREATE 
private static final String SQL DELETE 
/* 构造 函数 */ 
public DBHelper (Context context) { 
super (context, DB NAME, null, DB VERSION); 


"CREATE TABLE http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/..."; 
"DROP TABLE http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/0EBPS/Text/..."; 


} 

/* 初始 化 数据 库 */ 

GOverride 

public void onCreate(SQLiteDatabase db) { 
db.execSQL(SQL CREATE); 


} 

/* 升级 数据 库 */ 

GOverride 

public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 
db.execSQL(SQL DELETE); 

} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


此 外 ， 在 需要 使 用 的 时 候 ， 我 们 可 以 通过 getReadableDatabase 和 getWritableDatabase 来 获取 数据 库 句 柄 分 别 进行 读 和 写 的 操作 。 另 外 ， 数 据 库 文 件 会 被 存在 shared_prefs 和 files 的 同 级 目录 下 ， 
录 名 为 databases。 关 于 SQLite 数 据 库 的 更 多 用 法 ， 我 们 也 会 在 第 7 章 中 结合 具体 实例 做 进一步 的 介绍 。 


27 Android 应 用 界面 


Android 应 用 界面 系统 ， 即 Android UI (User Interface) 系统 是 Android 应 用 框架 最 核心 的 内 容 之 一 ， 也 是 开发 者 们 需要 重点 掌握 的 内 容 。 如 果 我 们 把 Android 应 用 也 分 为 前 后 端 两 部 分 的 话 ， 那 么 之 
前 介绍 的 核心 要 点 和 四 大 组 件 等 都 属于 后 端 ， 而 Android Ul 系 统 则 属于 前 端 。 后 端 保证 应 用 的 稳定 运行 ， 而 前 端 则 决定 应 用 的 外 观 和 体验 。 对 于 一 个 优秀 的 Android 应 用 来 说 ， 漂 亮 的 外 观 和 流畅 的 体验 是 
必 不 可 少 的 。 接 下 来 ， 我 们 便 来 学 习 Android 外 观 系统 的 知识 。 


在 2.3.3 节 中 我 们 已 经 简单 介绍 了 Android 应 用 框架 中 的 外 观 系 统 (View System) ， 也 就 是 Android UI 系统 的 基础 知识 。 我 们 知道 了 对 于 Android 应 用 来 说 ， 最 重要 的 两 个 基础 类 就 是 View 和 
ViewGroup: View 是 绝 大 部 分 UI 组 件 的 基础 类 ， 而 ViewGroup 则 是 所 有 Layout 布 局 组 件 的 基 类 。 当 然 ，ViewGroup 也 是 View 的 子 类 。 相 关 类 库 的 树 形 结构 如 下 。 


java.lang.Object 
|- android.view.View 
|- android.view.ViewGroup 
|- android.widget.FrameLayout 
|- android.widget.LinearLayout 
|- android.widget.TableLayout 
|- android.widget.RelativeLayout 
|- android.widget.AbsoluteLayout 


本 节 将 重点 介绍 Android 应 用 ( 非 游戏 ) 使 用 的 UI 系统 。 一 般 来 说 ， 我 们 都 使 用 XML 格 式 的 模板 文件 来 书写 对 应 的 UI 界面 ， 当 然 ， 这 种 做 法 也 比较 符合 MVC 的 设计 思想 。 另 外 ， 由 于 UI 模板 独立 于 逻辑 
之 外 ， 界 面 设计 师 们 就 可 以 更 加 专注 于 他 们 自己 的 事情 。 在 模板 文件 中 ， 每 个 UI 控件 都 由 对 应 的 XML 标 签 来 表示 ， 具 体 的 控件 标签 见 表 2-3， 大 家 可 以 回顾 一 下 。 


2.7.1 控件 属性 


我 们 知道 Android UI 系统 给 我 们 提供 了 丰富 多 彩 的 控件 ， 比 如 TextView、Button、TextView、EditText、ListView、CheckBox、RadioButton 等 ， 具 体 如 表 2-3 所 示 。 我 们 可 以 使 用 这 些 不 同 功能 的 
控件 来 完成 各 种 各 样 用 户 界面 的 需求 。 那 么 控件 本 身 的 属性 应 该 如 何 设置 呢 ? 实际 上 ， 每 个 UI 控件 都 有 很 多 的 属性 可 供 我 们 选择 ， 我 们 一 般 都 是 通过 设置 这 些 属性 来 设置 UI 控件 的 外 观 、 位 置 等 。 代 码 清单 
2-17 中 就 是 使 用 XML 来 表示 文本 框 控 件 (TextView) 的 示例 ， 实 际 的 显示 效果 是 在 整个 UI 界面 的 左上 方 打印 一 段 文字 “| am a TextView” , 


代码 清单 2-17 


<TextView android:id="@+id/text" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"I am a TextView" /» 


Android UI 控件 使 用 android: layout width#llandroid: layout_height 属 性 控制 其 宽度 和 高 度 ， 属 性 值 为 wrap_content 表 示 元 素 的 外 观 由 内 容 大 小 决定 ， 而 fil_parent 则 表示 元 素 大 小 由 外 层 的 元 素 
决定 。 我 们 经 常 使 用 人 ll_parent 来 实现 自 适 应 的 界面 布局 ， 因 为 最 外 层 的 元 素 必然 就 是 手机 屏幕 。 此 外 我 们 需要 注意 的 是 ， 这 两 个 属性 是 每 个 UI 控件 必须 指定 的 。 


另外 ，Android UI 控件 的 外 观 采 用 类 似 于 CSS 标 准 的 “盒子 模型 ”， 也 有 margin 和 padding 的 概念 ， 元 素 内 边 距 使 用 android: padding 来 表示 ， 外 边 距 则 采用 android: layout_margin 来 控制 。 这 两 
属性 也 是 我 们 最 常 使 用 的 “利器 ”之 一 ， 用 其 可 使 整个 界面 各 个 控件 之 间 的 间隔 更 为 合理 、 美 观 。Android UI 控件 “盒子 模型 ”如 图 2-7 所 示 ， 大 家 可 以 结合 示意 图 理解 一 下 。 


> 


android:layout_margin 


Flement Content 


图 2-7 £439 


最 后 ， 我 们 来 学 习 一 些 基础 的 Android UI 控件 属性 ， 这 些 属性 在 UI 组 件 基础 类 View 类 中 定义 ， 具 备 很 强 的 通用 性 ， 可 被 绝 大 部 分 的 UI 控件 所 使 用 ， 因 此 也 被 称 作 “通用 属性 ”。 对 于 我 们 来 说 ， 只 有 掌 
握 了 这 些 通用 属性 的 用 法 ， 才 能 够 更 好 地 控制 UI 组 件 并 运用 它们 组 装 出 各 种 各 样 的 Ul 界面。 


“android: id: 每 个 UI 控件 的 代表 性 id。 我 们 经 常 在 程序 中 使 用 findViewByld 方 法 来 选取 对 应 id 的 控件 ， 然 后 再 对 该 控件 进行 属性 控制 或 者 事件 处 理 ， 用 法 和 HTML 元 素 标签 属性 中 的 记 类 似 。 
: android: background: 控件 背景 ， 可 以 是 颜色 值 ， 也 可 以 是 图 像 或 者 Drawable 资 源 等 ， 如 果 值 为 @null， 则 表示 透明 背景 。 

:android: layout width: UI 控件 的 宽度 ， 常 见 属性 有 他 1_parent、wrap_parent 等 。 前 面 我 们 已 经 简单 介绍 过 这 个 属性 的 用 法 ， 它 是 每 个 控件 必须 有 具备 的 属性 之 一 。 

- android: layout height: UI 控件 的 高 度 ， 常 见 属性 和 用 法 和 宽度 一 样 ， 也 是 每 个 控件 必须 具备 的 属性 之 一 。 


- android: layout gravity: 用 于 控制 UI 控件 相对 于 其 外 层 控 件 的 位 置 ， 其 属性 值 就 代表 其 位 置 ， 如 顶部 (top) 、 底 部 (bottom) 、 左 边 (left) 、 右 侧 (right) > ÆA P (center vertical) 、 水 平 居 
"P (center horizontal) 、 绝 对 居中 (center) . 4 Ei 34 (fill vertical) 、 水 平 填 满 (ñll_horizontal) 、 完 全 填 满 (fl) 等 。 另外， 这 些 属性 可 以 并 列 存在 ， 我 们 常 使 用 “|” 符 号 隔 开 ， 
do “center_vertical | center_horizontal ”表示 垂直 水 平 居 中 。 


: android: layout margin: UI 控 件 的 外 边 距 ， 使 用 方式 见 图 2-7 所 示 的 “人 金子 模型 ”。 
android: padding: UI 控 件 的 内 边 距 ， 使 用 方式 见 图 2-7 所 示 的 “人 金子 模型 ”。 
: android: gravity: 控件 内 部 的 元 素 相 对 于 控件 本 身 的 位 置 ， 其 属性 值 和 使 用 方法 与 andtoid: layout_gravity 基 本 一 致 


: android: visibility: 显示 或 隐藏 控件 ， 控 件 默认 是 显示 状态 的 。 


通用 属性 常用 于 操控 UI 控 件 的 外 观 和 位 置 ， 通 常 能 对 Ul 界 面 的 构建 起 到 很 大 的 作用 。 当 然 ， 除 了 通用 属性 之 外 ， 不 同 的 UI 控 件 还 会 有 各 自 专 属 的 “控件 属性 ”， 这 些 属性 我 们 将 在 后 面 讲 到 各 种 UI 控 件 
的 概念 和 用 法 时 详细 介绍 ， 具 体内 容 可 参考 第 7 章 中 与 界面 控件 相关 的 章节 内 容 。 


2.7.2 布局 (Layout) 


Android UI 系统 中 的 布局 文件 其 实 和 HTML 有 点 类 似 ， 都 是 用 XML 标 签 所 代表 的 各 种 UI 控件 组 合 或 者 幅 套 而 成 的 ， 只 不 过 ，Android 模 板 文件 的 格式 比 HTML 更 严谨 些 ， 属 性 也 更 复杂 些 。 在 Android 
UI 界面 设计 中 ，Layout 布 局 控件 就 像 “建筑 师 ” 一 样 ， 帮 助 我 们 把 整个 界面 的 框架 布局 搭建 起 来 ， 并 把 每 个 控件 都 放 到 合适 的 位 置 上 。 我 们 最 经 常 使 用 的 布局 有 以 下 几 种 ， 我 们 来 逐个 介绍 一 下 。 


1. 基 本 布局 (FrameLayout) 


基本 布局 (FrameLayout) 是 所 有 Android 布 局 中 最 基本 的 ， 此 布局 实际 上 只 能 算是 一 个 “容器 ”， 里 面 所 有 的 元 素 都 不 能 被 指定 位 置 ， 默 认 会 被 堆放 到 此 布局 的 左上 角 。 此 布局 在 普通 的 应 用 中 
不 是 很 多 ， 但 是 因为 简单 高 效 ， 所 以 在 一 些 游戏 应 用 中 还 是 经 常 被 用 到 。 


2. 线 性 布局 (LinearLayout) 


线性 布局 (LinearLayout) 是 应 用 开发 中 最 常用 的 布局 之 一 ， 分 为 横向 和 纵向 两 种 ， 由 android: orientation 属 性 来 控制 。 当 属性 值 为 “horizontal” 时 表示 横向 的 线性 布局 ， 
面 ; 而 “vertical” 则 表示 纵向 也 就 是 垂直 的 线性 布局 ， 它 的 用 处 更 广 ， 普 通 应 用 中 的 大 部 分 界面 都 是 垂直 排列 的 ， 比 如 列表 界面 、 配 置 界面 等 。 


于 并 排 元 素 的 界 


gi 


线性 布局 的 用 法 很 简单 ， 就 拿 垂 直 的 线性 布局 来 说， 我 们 只 要 把 所 需 的 控件 按照 顺序 放 到 布局 标签 中 间 就 可 以 了 ，Android UI 系统 会 自动 按照 从 上 到 下 的 顺序 展示 出 来 。 代 码 清单 2-18 就 是 一 个 简单 的 
代码 示例 ， 其 功能 很 简单 ， 就 是 把 一 个 TextView 和 Button 垂 直 并 排 在 这 个 线性 布局 中 。 大 家 在 阅读 示例 代码 的 同时 可 以 顺便 复习 一 下 UI 控 件 属性 的 用 法 。 


代码 清单 2-18 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" » 
<TextView android:id="@+id/text id" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="I am a TextView" /> 
«Button android:id-"(-id/button id" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="I am a Button" /> 
</LinearLayout> 


3. 相 对 布局 (RelativeLayout) 


相对 布局 (RelativeLayout) 也 是 最 常 使 用 的 布局 之 一 ， 由 于 其 内 部 的 所 有 元 素 都 是 按照 相对 位 置 来 排列 的 ， 所 以 不 需要 幅 套 其 他 的 布局 ， 它 可 以 使 UI 模板 布局 更 加 地 简洁 和 高 效 。 该 布局 中 的 控件 元 
素 都 是 以 “参照 控件 ”为 准 来 排 布 的 ， 比 如 控件 属性 设置 为 “android: layout toRightOf="@ +id/referBox"””， 则 表示 该 控件 位 于 id 为 referBox 的 参照 控件 的 右边 。 以 下 是 相对 布局 中 其 他 常用 属性 的 列 
表 ， 供 大 家 参考 。 


- android: layout_toLeftOf: 该 控件 位 于 参照 控件 的 左 方 。 

- android: layout toRightOf: 该 控件 位 于 参照 控件 的 右 方 。 

“android: layout above: 该 控件 位 于 参照 控件 的 上 方 。 

- android: layout below: 该 控件 位 于 参照 控件 的 下 方 。 

:android: layout alignParentLeft: 该 控件 是 否 与 父 组 件 的 左 端 对 齐 。 

- android: layout alignParentRight: 该 控件 是 否 与 父 组 件 的 右 端 对 齐 。 

- android: layout alignParentTop: 该 控件 是 否 与 父 组 件 的 顶部 对 齐 。 

- android: layout alignParentBottom: 该 控件 是 否 与 父 组 件 的 底部 对 齐 。 
- android: layout centerlnParent: 该 控件 是 否 与 父 组 件 居中 对 齐 。 


: android: layout_centerHorizontal: 该 控件 是 否 与 父 组 件 横向 居中 对 齐 。 


: android: layout centerVertical: 该 控件 是 否 与 父 组 件 重 直 居 中 对 齐 。 


4. 绝 对 布局 (AbsoluteLayout) 


绝对 布局 (AbsoluteLayout) 的 用 法 类 似 于 HTML 中 的 层 属性 “position=absolute”， 该 布局 内 部 的 控件 可 以 使 用 android: layout_x 和 android: layout_y 两 个 属性 来 指定 它 相对 于 布局 坐标 轴 原 点 
的 X 轴 和 Y 轴 方向 的 距离 。 图 2-8 就 是 绝对 布局 的 示意 图 。 


图 2-8 ”绝对 布局 的 示意 


大 家 如 果 熟 悉 HTML 的 话 ， 应 该 非常 熟悉 表格 布局 (TableLayout) ， 像 一 些 表格 型 的 信息 列表 都 是 使 


表格 布局 的 主要 标签 ， 整 个 表格 布局 的 框架 ， 类 似 于 HTML 标 签 中 的 <table/> ;后 者 是 表格 行 ， 类 似 于 HTML 标 签 中 的 <th/> 或 者 <tr/>。 表 格 布局 的 使 


代码 清单 2-19 


表格 布 


局 来 展示 的 。 表 格 型 布 


局 的 标签 有 两 个 


<TableLayout/> 和 <TableRow/>， 前 者 是 
范例 如 代码 清单 2-19 所 示 。 


<?xml version-"1.0" encoding-"utf-8"?» 


android:layout height-"fill parent" 
android:stretchColumns-"0,1,2"» 
<TableRow> 
<TextView android:gravity="center" android:text="ID"/> 
<TextView android:gravity="center" android: text="NAME"/> 
</TableRow> 
<TableRow> 
<TextView android:gravity="center" android:text="1"/> 
<TextView android:gravity="center" android:text="james"/> 
«Button android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:gravity-"center" 
android:text-"Edit"/» 
«/TableRow» 
<TableRow> 
<TextView android:gravity="center" android:text="2"/> 
<TextView android:gravity="center" android:text="iris"/> 
«Button android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:gravity-"center" ^ 
android:text-"Edit"/» 
«/TableRow» 
</TableLayout> 


上 述 XML 模 板 的 最 终 显示 结果 如 图 2-9 所 示 ， 我 们 可 以 看 到 ， 这 是 一 个 3 行 3 列 的 标准 表格 结构 ， 对 应 到 代码 中 就 是 3 个 <TableRow/> 标 签 ， 每 个 标签 中 包含 3 个 控件 。 


图 2-9 ”表格 布局 示例 


另外 ， 我 们 还 要 注意 的 是 ，<TableLayout/> 有 3 个 很 重要 的 属性 : android: stretchColumns, android: shrinkColumns 和 android: collapseColumns， 分 别 对 应 的 是 拉 伸 、 收 缩 和 隐藏 列 行为 ， 
如 代码 清单 2-19 中 我 们 使 用 “android: stretchColumns="0，1，2"”， 就 表示 所 有 列 都 是 拉 伸 状态 ， 因 此 每 列 中 的 控件 才 会 平分 并 填 满 整 行 的 空间 ; 假如 我 们 设置 “android : 
collapseColumns= "2"””， 那 么 最 右边 的 列 将 会 被 隐藏 。 


ill 


标签 布局 (TabLayout) 在 移动 应 用 中 是 相当 流行 的 ， 其 用 法 相对 比 其 他 布局 复杂 一 些 ， 需 要 配合 程序 来 实现 。 接 下 来 我 们 来 看 一 个 简单 的 标签 布局 的 实例 ， 其 模板 文件 如 代码 清单 2-20 所 示 。 


代码 清单 2-20 


<?xml version="1.0" encoding="utf-8"?> 
<TabHost xmlns:android-"http://schemas.android.com/apk/res/android" 
android: id="@android: id/tabhost_id" 
android: layout_width="fill parent" 
android: layout_height="fill parent"> 
<LinearLayout android:orientation-"vertical" 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
android:padding-"5dp"» 
<TabWidget android:id-"&android:id/tabtitle id" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
<FrameLayout android: id="@android:id/tabcontent_id" 
android: layout_width="fill parent" 
android:layout height-"fill parent" /> 
</LinearLayout> 
</TabHost> 


此 界面 最 外 面 是 一 个 <TabHost/> 标 签 ， 里 面 庶 套 了 一 个 垂直 的 线性 布局 ， 该 线形 布局 里 面 又 包含 了 一 个 <TabWidget/> 和 <FrameLayout/> ， 这 些 标签 都 是 需要 在 程序 中 设置 的 。 紧 接着 ， 在 模板 对 
应 的 Activity 类 中 设置 该 TabLayout 的 逻辑 ， 使 用 范例 见 代 码 清单 2-21。 


代码 清单 2-21 


public class TabDemo extends TabActivity { 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
// 初始 化 资源 对 象 
Resources res = getResources(); 
TabHost tabHost = getTabHost (); 
TabHost.TabSpec ts; 
Intent intent; 
// 设置 第 1 个 Tab 
intent = new Intent().setClass(this, TablActivity.class); 
ts = tabHost 
.newTabSpec ("tab1") 
-setIndicator("Tab1", res.getDrawable (R.drawable.ic tab 1)) 
.SetContent (intent); 
tabHost .addTab (ts) ; 
// 设置 第 2 个 Tab 
intent = new Intent().setClass(this, Tab2Activity.class); 
ts = tabHost 
.newTabSpec ("tab2") 
-setIndicator ("Tab2", res.getDrawable (R.drawable.ic tab 2)) 
.SetContent (intent); 
tabHost .addTab (ts) ; 
// 设置 第 3 个 Tab 
intent = new Intent().setClass(this, Tab3Activity.class); 
ts = tabHost 
-newTabSpec ("tab3") 
.setIndicator("Tab3", res.getDrawable (R.drawable.ic tab 3)) 
.setContent (intent); 
tabHost .addTab (ts) ; 


// 设置 默认 选中 Tab 
tabHost.setCurrentTab (0) ; 
} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


我 们 从 代码 注释 中 可 以 清楚 地 看 到 ， 在 该 实例 中 我 们 添加 了 3 个 Tab 标 签 ， 程 序 使 用 newTabSpec 方 法 获取 TabHost.TabSpec 对 象 ， 然 后 使 用 setindicator 和 setContent 方 法 设置 Tab 的 顶部 样式 和 内 部 
信息 ， 最 后 再 调用 setCurrentTab 方 法 设置 默认 选中 的 标签 页 。 最 后 ， 分 别 实现 Tab1Activity、Tab2Activity 和 Tab3Activity 界 面 类 的 逻辑 ， 并 加 入 声明 到 Manifest 应 用 的 配置 文件 中 。 至 此 ， 整 个 标签 布局 
的 设置 就 完成 了 。 


2.7.3 事件 (Event) 


了 解 完 UI 控 件 和 界面 布局 的 基本 知识 之 后 ， 我 们 还 需要 知道 如 何 控制 这 些 界面 上 的 控件 元 素 。Android 应 用 框架 为 我 们 提供 了 事件 机 制 来 处 理 用 户 触发 的 动作 ， 常 见 的 事件 包括 键盘 事件 KeyEvent、 输 
入 事件 InputEvent、 触 屏 事件 MotionEvent 等 。 在 实际 应 用 中 ， 我 们 需要 掌握 如 何 响应 当 用 户 操作 这 些 控件 时 所 触发 的 事件 。 比 如 ， 用 户 点 击 某 个 按钮 控件 (Button) 之 后 需要 执行 一 些 程序 逻辑 ， 此 时 我 
们 需要 使 用 Android 系 统 给 我 们 提供 的 事件 监听 器 Listener 来 捕获 按钮 的 点 击 事件 来 执行 这 些 逻 辑 。 本 节 中 我 们 将 会 介绍 Android 应 用 框架 中 比较 常见 的 监听 器 。 


1.View.OnClickListener 事 件 


View.OnClickListener 是 最 经 常 使 用 的 监听 器 之 一 ， 用 于 处 理 点 击 事件 。 其 实 , 该 类 也 是 View 基 类 中 的 公用 接口 ， 其 接口 方法 为 onClick (View v) 。 方 法 只 有 一 个 参数 ， 就 是 点 击 事件 触发 的 控件 对 
象 的 本 身 。 我 们 在 使 用 过 程 中 必须 实现 onClick 方 法 ， 也 就 是 把 点 击 之 后 需要 处 理 的 逻辑 代码 放 到 此 方法 中 。 代 码 清单 2-22 就 是 相关 的 使 用 范例 。 


代码 清单 ”2-22 


btnObj = (Button) this.findViewById(R.id.demo_btn_id); 
btnObj.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick(View v) { 
// 按钮 点 击 之 后 的 动作 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


上 面 的 代码 实现 的 就 是 id 为 demo_btn_id 的 按钮 控件 的 点 击 事件 ， 我 们 在 使 用 findViewByld 获 取 到 按钮 实例 对 象 之 后 ， 又 通过 setOnClickListener 方 法 设置 View.OnClickListener 监 听 器 对 象 的 实现 ， 
点 击 事件 需要 处 理 的 逻辑 我 们 会 在 onClick 方 法 中 实现 。 大 家 可 以 看 到 ，Android Ul 事件 的 概念 和 用 法 与 JavaScript 语 言 有 点 类 似 。 


2.View.OnFocusChangeListener 事 件 


监听 器 View.OnFocusChangeListener 用 于 处 理 选 中 事件 ， 比 如 界面 中 有 若干 个 UI 控 件 ， 当 需要 根据 选中 不 同 的 控件 来 处 理 不 同 的 逻辑 时 ， 就 可 以 使 用 按钮 控件 对 象 的 setOnFocusChangelListener 方 
法 来 设置 View.OnClickListener 监 听 器 对 象 。 选 中 需要 处 理 的 逻辑 会 在 该 监听 器 对 象 的 onFocusChange 方 法 中 实现 。 


onFocusChange 方 法 有 两 个 参数 : 第 一 个 是 事件 触发 的 控件 对 象 ， 我 们 可 以 用 其 判断 并 处 理 不 同 控件 的 触发 事件 ， 另 一 个 则 是 布尔 型 的 值 ， 表 示 该 控件 对 象 的 最 新 状态 。 另 外 ， 监 听 器 的 具体 用 法 和 
View.OnClickListener 类 似 。 


3.View.OnKeyListener 事 件 


监听 器 View.OnKeyListener 用 于 处 理 键 盘 的 按键 。 我 们 可 以 在 该 监听 器 的 onKey 方 法 中 处 理 用 户 点 击 不 同 按键 时 所 需要 处 理 的 逻辑 。 在 Android 的 键盘 系统 中 ， 每 个 按键 都 有 自己 的 代码 ， 也 就 是 
keyCode。 需 要 注意 的 是 ，onKey 方 法 的 第 二 个 参数 传递 的 就 是 用 户 点 击 按键 的 keyCode， 而 后 我 们 就 可 以 使 用 switch 语 句 来 处 理 不 同 的 按键 事件 了 。 这 个 思路 其 实 和 JavaScript 中 的 onkey 系 列 方法 非常 
类 似 ， 读 者 如 果 熟 悉 JavaScript 的 话 ， 可 以 对 照 着 学 习 一 下 。 


4.View.OnTouchListener 事 件 


监听 器 View.OnTouchListener 用 于 处 理 Android 系 统 的 触 屏 事件 。 如 果 我 们 需要 对 一 些 触摸 动作 做 处 理 ， 或 者 需要 处 理 比 点 击 动作 此 类 动作 更 细 粒 度 的 动作 的 话 ， 就 要 用 到 这 个 监听 器 了 。 此 监听 器 必 
须 实现 的 接口 方法 是 onTouch (View v, MotionEvent event) ， 我 们 需要 注意 的 是 第 二 个 参数 ， 因 为 这 个 参数 表示 的 是 用 户 触发 的 动作 事件 ， 我 们 可 以 根据 这 个 参数 的 值 来 处 理 比较 复杂 的 手势 
(gesture) 动作 。 


MotionEvent 事 件 中 比较 常见 的 动作 和 手势 常量 的 说 明 如 下 ， 供 大 家 参考 。 

: ACTION DOWN: 按 下 手势 ， 包 含 用 户 按 下 时 的 位 置信 息 。 

: ACTION UP: 松 开 手 势 ， 包 含 用 户 离开 时 的 位 置信 息 。 

: ACTION MOVE: 拖 动 手势 ， 包 含 最 新 的 移动 位 置 。 

: ACTION CANCEL: 结束 手势 ， 类 似 于 ACTION_UP， 但 是 不 包含 任何 位 置信 息 。 
: ACTION OUTSIDE: 离开 控件 元 素 时 所 触发 的 事件 ， 只 包含 初始 的 位 置信 息 。 

: EDGE BOTTOM: 碰 触 屏幕 底部 时 所 触发 的 事件 。 

: EDGE LEFT: 碰 触 屏幕 左边 时 所 触发 的 事件 。 

: EDGE RIGHT: 碰 触 屏幕 右边 时 所 触发 的 事件 。 

: EDGE TOP: 碰 触 屏幕 顶部 时 所 触发 的 事件 。 

: ACTION_MASK: 多 点 触 磁 事件 的 标志 ， 可 用 于 处 理 多 点 触摸 事件 。 

- ACTION POINTER DOWN: 第 二 点 按 下 时 的 触发 事件 。 


: ACTION POINTER UP: 第 二 点 松 开 时 的 触发 事件 。 


可 以 想象 ， 如 果 缺 少 事件 响应 的 支持 ，Android 应 用 的 界面 将 会 变 得 毫 无 交互 性 。 因 此 ， 学 会 使 用 UI 控件 的 各 种 响应 事件 的 用 法 对 于 Android 应 用 开发 来 说 是 非常 重要 的 。 通 常情 况 下 ， 我 们 会 使 用 不 
同 的 事件 来 让 界面 中 的 元 素 生动 起 来 。 比 如 ， 我 们 可 以 通过 实现 某 个 UI 控件 的 View.OnClickListener 事 件 来 响应 用 户 的 点 击 动作 (如 代码 清单 2-22 所 示 ) ， 或 者 还 可 以 使 用 View.OnTouchListener 事 件 来 
响应 一 些 更 加 复杂 的 动作 。 


2.7.4 328 (Menu) 


菜单 是 Android 应 用 系统 中 最 有 特色 的 功能 之 一 ， 也 是 每 个 Android 应 用 必 不 可 少 的 组 件 之 一 。 合 理 地 使 用 菜单 不 仅 可 以 帮助 我 们 节省 界面 空间 ， 还 可 以 提升 用 户 的 操作 体验 。 一 般 ， 我 们 最 常用 的 菜单 
有 以 下 3 种 ， 下 面 我 们 分 别 来 学 习 一 下 。 


1. 选 项 菜单 (Options Menu) 


选项 菜单 (Options Menu) 是 Android 应 用 中 最 经 常 被 使 用 的 菜单 ， 当 用 户 按 下 系统 菜单 键 时 出 现 。 在 Activity 中 ， 我 们 通常 使 用 onCreateOptionsMenu 方 法 来 初始 化 菜单 项 ， 然 后 再 使 有 
onOptionsltemSelected 方 法 处 理 每 个 菜单 项 选中 时 的 逻辑 。 使 用 范例 如 代码 清单 2-23 所 示 。 


代码 清单 ”2-23 


public class MenuActivity extends Activity { 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 

GOverride 

public boolean onCreateOptionsMenu (Menu menu) { 
super.onCreateOptionsMenu (menu) ; 
// 添加 书写 按钮 菜单 项 
menu.add(0, MENU APP WRITE, 0, R.string.menu_app_write) .setIcon (http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/T 
// 添加 注销 按钮 菜单 项 
menu.add(0, MENU APP LOGOUT, 0, R.string.menu_app_logout) .setIcon (http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS 
return true; 


} 


GOverride 
public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId()) ( 


case MENU APP WRITE: 
// 点 击 书 写 菜单 项 之 后 的 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
break; 

case MENU APP LOGOUT: 
// 点 击 注销 菜单 项 之 后 的 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
break; 

} 


return super.onOptionsItemSelected (item) ; 


当然 ， 如 果 我 们 需要 添加 一 些 每 次 菜单 加 载 时 都 需要 执行 的 逻辑 ， 则 需要 使 用 onPrepareOptionsMenu 方 法 来 处 理 ， 因 为 onCreateOptionsMenu 只 在 菜单 项 初始 化 的 时 候 执行 一 次 。 


2. 上 下 文 菜单 (Context Menu) 


上 下 文 菜单 (Context Menu) 的 概念 和 PC 上 应 用 软件 的 快捷 菜单 有 点 类 似 ， 在 UI 控件 注册 了 此 菜单 对 象 以 后 ， 长 按 视图 控件 (2 秒 以 上 ) 就 可 以 唤醒 上 下 文 菜单 。 在 Activity 类 中 ， 我 们 可 以 使 
onCreateContextMenu 方 法 来 初始 化 上 下 文 菜单 。 和 选项 菜单 略微 不 同 的 是 ， 此 方法 在 每 次 菜单 展示 的 时 候 都 会 被 调用 。 另 外 ， 处 理 上 下 文 菜单 点 击 事件 的 方法 名 为 onContextltemSelected， 其 用 法 和 
前 面 介绍 的 选项 菜单 中 的 onOptionsltemSelected 方 法 类 似 。 


3. 子 菜单 (Submenu) 


在 Android 应 用 中 点 击 子 菜单 时 会 弹出 悬浮 窗口 显示 子 菜单 项 ， 子 菜单 (Submenu) 可 以 被 添加 到 其 他 的 菜单 中 去 。 使 用 方法 也 很 简单 ，Submenu 的 使 用 范例 如 代码 清单 2-24 所 示 。 我 们 需要 注意 的 
是 ， 子 菜单 是 不 可 以 谋 套 的 ， 即 子 菜单 中 不 能 再 包含 其 他 子 菜单 ， 我 们 在 使 用 的 时 候 必须 注意 这 个 问题 。 


代码 清单 ”2-24 


publicboolean onCreateOptionsMenu (Menu menu) { 
// 初始 化 变量 
int base = Menu.FIRST; 
// 添加 子 菜单 
SubMenu subMenu = menu.addSubMenu (base, base+1, Menu.NONE, " 子 菜单 -1") 7 
// 设置 图 标 
subMenu. setIcon (R.drawable.settings); 
// 添加 子 菜单 项 
subMenu.add (base，base+1，base+1，" 子 菜单 项 -1") 7 
subMenu.add (base，base+2，base+2，" 子 菜单 项 -2") 7 
subMenu.add (base，base+3，base+3，" 子 菜单 项 -3") 7 
return true; 


} 


以 上 我 们 介绍 了 Android 系 统 中 最 常见 的 几 种 菜单 的 概念 和 基本 用 法 ， 关 于 菜单 组 件 实际 运用 的 更 多 信息 ， 我 们 将 在 实战 篇 的 7.5.1 节 中 结合 实际 案例 做 进一步 的 介绍 。 


2.7.5 主题 (Theme) 


框架 为 我 们 提供 了 样式 (style) 和 主题 (theme) 两 个 功能 。 这 两 个 功能 让 我 们 可 以 更 好 地 控制 UI 界面 的 外 观 ， 并 可 以 实现 一 


为 了 让 Android UI 界面 开发 更 加 快速 方便 ， 同 时 具有 更 好 的 复 用 性 ， 应 
些 更 高 级 的 功能 ， 比 如 换 肤 功能 等 。 


首先 ， 需 要 了 解 的 是 ， 我 们 通常 会 把 样式 和 主题 的 声明 放 在 Android 应 用 框架 的 资源 目录 res/values/ 下 的 styles.xml 文 件 中 ， 使 用 范例 如 代码 清单 2-25 所 示 。 


代码 清单 ”2-25 


<?xml version-"1.0" encoding="ut£-8"2> 
<resources> 
<style name="CommonText" parent="@style/Text"> 
<item name="android:textSize">12px</item> 
<item name="android:textColor">#008</item> 
</style> 
</resources> 


我 们 可 以 看 到 ， 在 这 个 样式 文件 中 我 们 声明 了 一 个 名 为 “CommonText” 的 样式 ， 里 面包 含 了 该 样式 的 两 个 属性 : 字体 大 小 “android: textsize” 和 字体 颜色 “android: textColor” 属 性 。 另 外 ， 
样式 是 支持 继承 的 ， 比 如 ， 该 样式 就 继承 自 系统 的 基础 “Text” 样 式 ， 这 种 使 用 parent 属 性 设置 父 样式 的 用 法 还 是 比较 容易 理解 的 。 了 解 完 样式 和 主题 的 写法 ， 接 下 来 让 我 们 认识 一 下 样式 和 主题 之 间 的 


别 。 


网 


1. 样 式 (style) 


Android 的 UI 系统 中 ， 样 式 (style) 的 概念 和 CSSs 中 样式 的 概念 非常 类 似 ， 我 们 可 以 把 一 些 常用 的 样式 提取 出 来 ， 比 如 代码 清单 2-20 中 ， 我 们 就 把 一 种 常见 的 文字 样式 提取 出 来 并 保存 
为 “CommonText” 的 样式 。 应 用 样式 的 时 候 ， 我 们 只 需要 在 对 应 控件 的 声明 中 加 上 “style= "@style/CommonText"” 属性 值 即 可 。 一 般 来 说 ， 样 式 都 只 会 被 应 用 于 单个 View 控 件 中 。 


2. 主 题 (theme) 


与 样式 不 同 ， 主 题 (theme) 一 般 被 用 于 更 外 层 的 ViewGroup 控 件 中 ， 比 如 ， 我 们 需要 让 Activity 下 所 有 控件 的 字体 都 用 CommonText 的 样式 ， 那 么 我 们 就 可 以 在 应 用 配置 文件 中 的 <activity/> 标 签 加 
-E “android: theme="CommonText"” 的 属性 。 但 是 ， 如 果 我 们 把 样式 用 在 ViewGroup 上 ， 对 于 ViewGroup 之 下 的 其 他 View 控 件 却 是 没有 影响 的 。 另 外 ，Android 系 统 还 定义 了 几 个 基本 的 系统 主题 供 
我 们 使 用 ， 比 如 Theme.Light 主 题 就 是 以 亮色 背景 为 基调 的 主题 样式 。 


学 会 灵活 使 用 样式 和 主题 来 泻 染 Android 应 用 的 Ul 界 面 是 非常 重要 的 ， 因 为 该 技术 不 仅 可 以 让 界面 设计 更 加 容易 ， 还 可 以 简化 模板 文件 的 代码 ， 减 少 开 发 成 本 。 因 此 ， 在 实践 的 过 程 中 ， 我 们 要 有 意识 
地 去 运用 这 些 知识 和 技巧 ， 逐 渐 掌握 Android UI 系统 的 使 用 。 


2.7.6 XH (Dialog) 


在 Android 应 用 界面 中 ， 经 常 需要 弹出 一 些 悬 浮 于 底层 Ul 界 面 之 上 的 操作 窗口 。 当 这 种 窗口 显示 的 时 候 ， 底 层 界面 通常 会 被 半 透 明 层 所 覆盖 住 ， 焦 点 则 会 被 该 窗口 获得 ， 这 种 窗口 就 被 称 为 对 话 框 ， 或 
者 是 Dialog。 应 用 中 常用 的 Dialog 有 提示 对 话 框 (AlertDialog) 、 进 度 对 话 框 (ProgressDialog) 、 日 期 选择 对 话 框 (DatePickerDialog) 以 及 时 间 选 择 对 话 框 (TimePickerDialog) 等 。 在 本 节 中 ， 我 
们 将 重点 介绍 其 中 较 常 使 用 的 两 种 Dialog 的 用 法 。 


1 .提示 对 话 框 (AlertDialog) 


提示 对 话 框 (AlertDialog) 可 以 算是 Android 应 用 中 最 经 常 使 用 的 对 话 框 控 件 了 ， 其 主要 用 于 显示 提示 信息 ， 当 然 ， 可 以 加 上 确认 和 取消 (YES 和 NO) 按钮 。 创 建 AlertDialog 需 要 使 
AlertDialog.Builder 子 类 ， 代 码 清单 2-26 演 示 了 创建 AlertDialog 对 话 框 的 标准 过 程 。 


代码 清单 2-26 


AlertDialog.Builder builder = new AlertDialog.Builder (this) ; 
builder.setMessage ("Are you sure you want to exit?") 
.setCancelable (false) 
.setPositiveButton("Yes", new DialogInterface.OnClickListener() ( 
public void onClick(DialogInterface dialog, int id) ( 
MyActivity.this.finish(); 
} 
D 
.setNegativeButton("No", new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int id) ( 
dialog.cancel(); 


} 


n; 
AlertDialog alert - builder.create(); 
alert.show(); 


在 以 上 代码 中 ， 首 先 使 用 AlertDialog.Builder (Context) 方法 来 获取 Builder 对 象 ， 然 后 使 用 Builder 类 提供 的 公用 方法 来 设置 AlertDialog 的 文字 和 属性 ， 接 着 使 用 该 类 的 create 方 法 来 创建 
AlertDialog 对 象 ， 最 后 调用 show 方 法 展示 该 对 话 框 。 显 示 效 果 如 图 2-10 所 示 。 


Are you sure you want to exit? 


2-10 提示 对 话 框 示例 


2. 进 度 对 话 框 (ProgressDialog) 


进度 对 话 框 (ProgressDialog) 在 Android 应 用 开发 中 也 经 常会 用 到 ， 主 要 用 于 在 耗 时 操作 等 待 时 显示 。 其 用 法 比较 简单 ， 一 般 情 况 下 ， 只 需要 调用 ProgressDialog 的 show 方 法 即 可 ， 如 代码 清单 2- 
27 所 示 。 


代码 清单 2-27 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
ProgressDialog dialog = ProgressDialog.show(this, "", "Loading. Please waithttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Te 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


以 上 代码 创建 了 一 个 最 基本 的 进度 对 话 框 ， 显 示 效 果 如 图 2-11 所 示 。 


Loading, Please wail... 


2-11 进度 对 话 框 示例 


当然 ，ProgressDialog 类 还 提供 了 丰富 的 对 话 框 属 性 设置 方法 ， 如 设置 进度 条 的 样式 、 标 题 、 提 示 信 息 ， 以 及 是 否 显示 按钮 等 。 更 多 用 法 示例 可 参考 后 面 7.11.3 节 中 的 内 容 。 至 于 其 他 对 话 框 的 用 法 由 
于 篇 幅 原 因 ， 这 里 不 做 详细 介绍 。 


[I 


前 面 介绍 了 Android 应 用 界面 (Android UI) 的 相关 内 容 ， 不 过 对 于 一 些 游戏 应 用 来 说 ， 这 些 UI 控 件 往往 派 不 上 用 场 。 此 外 ， 一 些 特 殊 的 Android 应 用 也 有 可 能 会 使 用 到 比较 底层 的 图 形 类 库 ， 因 此 ， 
本 节 我 们 就 来 学 习 Android 的 图 形 系统 。 


Android 系 统 中 的 图 形 大 致 可 以 分 为 2D 图 形 和 3D 图 形 两 类 ，2D 图 形 的 类 库 在 android.graphics 包 下 ， 本 节 将 会 重点 介绍 ; 3D 图 形 的 类 库 在 android.opengl 包 下 ， 由 于 这 部 分 内 容 和 游戏 开发 关系 比较 
紧密 ， 这 部 分 内 容 将 被 放 在 本 书 第 13 章 中 介绍 ， 感 兴趣 的 朋友 可 以 提前 参考 13.1.4 节 中 的 内 容 。 


首先 ， 让 我 们 来 想象 一 下 ， 当 我 们 绘画 的 时 候 ， 最 重要 的 两 样 东 西 是 什么 ”答案 应 该 没有 什么 悬念 ， 那 就 是 画笔 和 画布 。 实 际 上 ， 在 Android 系 统 中 绘制 图 形 的 原理 是 相同 的 ， 我 们 同样 需要 先 使 用 程 
序 构造 一 把 画笔 (Paint) ， 然 后 在 画布 (Canvas) 上 进行 绘画 。 


Android 系 统 中 的 画笔 类 ， 即 android.graphics 包 下 的 Paint 类 ， 该 类 包含 了 一 系列 的 方法 与 属性 ， 用 于 构造 绘制 图 形 


的 画笔 。 我 们 把 常用 的 方法 归纳 到 表 2-5 中 。 


方法 名 说 明 


setARGB(int a. int r. int g. int b) 设置 画笔 透明 度 以 及 RGB 颜色 
setAlpha(int a) 设置 画笔 透明 度 
setAntiAlias(boolean aa) 设置 抗 锯齿 效果 

setColor(int color) 设置 画笔 颜色 
setLinearText(boolean linearText) 设置 线性 文本 
setPathEffect(PathEffect effect) 设置 路 径 效 果 

setShader(Shader shader) 设置 阴影 效果 
setStyle(Paint.Style style) 设置 画笔 样式 
setTextScaleX(float scaleX) 设置 文本 缩放 效果 
setTextSize(float textSize) 设置 字体 大 小 


以 上 方法 常用 于 画笔 初始 化 的 配置 逻辑 中 ， 接 下 来 让 我 们 来 学 习 Paint 画 笔 类 的 使 用 范例 ， 如 参考 代码 清单 2-28 所 示 。 


代码 清单 2-28 


public class TestPaintView extends View { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
private Paint mPaint = new Paint(); u 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public void onDraw(Canvas canvas) { B 
super.onDraw (canvas); 
// 设置 画笔 
mPaint.setAntiAlias (true) ; 
mPaint.setColor (Color.RED) ; 
mPaint.setAlpha (200); 
mPaint.setStyle (Paint.Style.FILL) ; 
// 绘制 矩形 
canvas.drawRect (100, 100, 150, 150, mPaint); 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


以 上 视图 类 TestPaintView 继 承 自 View 基 类 ， 主 要 的 绘制 逻辑 在 onDraw 方 法 中 ， 即 使 用 定制 好 的 实心 画笔 绘制 一 个 红色 的 矩形 ， 这 里 我 们 可 以 学 习 到 使 用 Paint 画 笔 类 的 正确 方法 。 此 外 ， 我 们 还 需要 
注意 ， 这 里 在 使 用 setColor 方 法 设置 画笔 颜色 的 时 候 ， 用 到 了 Color 类 的 预定 义 颜 色 常 量 ， 我 们 将 这 些 常用 的 颜色 常量 归纳 到 表 2-6 中 。 


表 2-6 画笔 类 颜色 常量 


常量 名 说 明 
Color. BLACK 黑色 
ColorBLUE 蓝 色 
Color.CYAN 青绿 色 
Color. DKGRAY TK TR. f 
Color.GRAY 灰色 
Color.GREEN 绿色 
Color.LTGRAY 浅 灰色 
ColorMAGENTA 红 紫 色 
Color.RED 红色 
ColorTRANSPARENT 透明 
Color WHITE 白色 
Color.YELLOW 黄色 


2.8.2 画布 (Canvas) 


设置 好 画笔 和 颜色 ， 就 可 以 开始 在 画布 上 绘画 了 ， 这 时 我 们 就 需要 用 到 画布 类 ， 即 Canvas 类 。 该 类 包含 了 一 系列 的 方法 与 属性 ， 用 于 设置 画布 的 外 观 ， 我 们 把 常用 的 方法 归纳 到 表 2-7 中 。 


Canvas 类 中 常用 绘制 方法 的 用 法 比较 简单 ，Android 系 统 已 经 在 View 类 的 onDraw 方 法 中 默认 传 入 了 canvas 对 象 ， 我 们 可 以 根据 需要 使 用 不 同 的 draw 方 法 绘制 出 不 同 的 图 形 。 比 如 ， 代 码 清单 2-29 中 
就 使 用 了 drawRect 方 法 绘制 了 一 个 矩形 。 


27 ”画布 类 常用 方法 


方法 名 说 明 


clipRect(int left. int top. int right. int bottom) 剪裁 画布 ， 即 需要 绘制 的 部 分 
drawARGB(int a. int r. int g. int b) 设置 整个 画布 的 颜色 
drawBitmap(Bitmap bitmap. float left. float top. Paint paint) 绘制 位 图 
drawCircle(float cx. float cy. float radius. Paint paint) 绘制 圆 形 
drawColor(int color) 设置 画布 背景 色 
drawLine(float startX. float startY. float stopX. float stopY. Paint paint) 绘制 线形 
drawOval(RectF oval. Paint paint) 绘制 椭圆 
drawPoint(float x. float y. Paint paint) 绘制 点 形 
drawRect(float left. float top. float right. float bottom. Paint paint) 绘制 矩形 
drawText(String text. float x. float y. Paint paint) 绘制 文字 

restore() 重 置 画布 

rotate(float degrees) 旋转 画布 


save() 保存 画布 


然而 ， 游 戏 应 用 的 画布 中 通常 不 只 有 一 个 图 形 ， 通 常 需要 对 其 中 的 某 些 图 形 进行 特殊 处 理 ， 比 如 旋转 、 变 形 等 ， 此 时 需要 先 使 用 save 方 法 来 保存 画布 ， 图 形 处 理 完毕 之 后 再 调用 restore 方 法 来 重 置 、 重 
绘 ， 使 用 范例 如 代码 清单 2-29 所 示 。 


代码 清单 2-29 


public class TestCanvasView extends View { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
private Paint mPaint = new Paint(); 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onDraw(Canvas canvas) { 
super.onDraw (canvas) ; 
// 设置 画布 颜色 
canvas.drawColor (Color... BLACK) ; 
// 设置 画笔 
mPaint.setAntiAlias (true) ; 
// 剪裁 画布 
canvas.clipRect (0, 0, 200, 200); 
// 保存 画布 
canvas.save(); 
// 绘制 一 个 矩形 
canvas.rotate(10.0f); 
mPaint.setColor (Color.RED); 
canvas.drawRect(100, 100, 150, 150, mPaint); 
// $E sj 
canvas.restore () ; 
// RAAEN 
mPaint.setColor (Color.BLUE) ; 


canvas.drawRect (100, 0, 200, 100, mPaint); 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


和 游戏 中 方便 地 绘 


设置 、 保 存 、 旋 转 、 重 置 等 一 系 有 


283 ”基础 几何 图 形 


绘制 矩形 ， 但 是 大 家 可 能 还 不 清楚 方法 中 参数 值 的 含义 ， 


前 面 我 们 已 经 学 习 了 画笔 (Paint) 和 画布 (Canvas) 的 基础 知识 ， 接 下 来 我 们 就 可 以 使 
因此 我 们 先 来 熟悉 Canvas 画 布 的 坐标 系 ， 如 


以 上 程序 绘制 了 两 个 和 矩形。 其中， 红色 的 矩形 绕 着 
的 操控 过 程 。 学 习 了 以 上 Paint 和 Canvas 类 的 编程 技巧 之 后 ， 开 发 者 就 可 以 在 Android 应 | 


了 。 实 际 上 ， 在 前 面 的 代码 范例 中 ， 我 们 已 经 介绍 了 如 何 使 


这 些 工具 来 画图 
图 2-12 所 示 。 


幕 左上 方 的 顶点 顺 时 间 旋 转 了 10"。 这 里 涉及 Canvas 画 布 坐标 系 的 知识 ， 我 们 将 在 2.8.3 节 中 介绍 。 另 外 ， 我 们 还 可 以 学 习 到 如 何 对 Canvas 画 布 进行 


Canvas 对 象 的 drawRect 方 法 来 


sa e zzl 


(00) i X 
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(right, bottom) 


图 2-12 Canvas Æ 45 A 


从 以 上 的 坐标 系 示意 图 中 ， 我 们 可 以 看 出 以 下 几 个 要 点 。 其 一 ，Canvas 画 布 的 坐标 原点 位 于 整 张 画 布 的 左上 方 ， 点 坐标 为 (0, 0)" ; 其 二 ， 屏 幕 横向 的 是 X 轴 ， 纵 向 的 是 Y 轴 ， 屏 幕 内 的 点 坐标 都 
是 正 数 ; 其 三 ， 以 矩形 为 例 ， 我 们 可 以 看 到 绘图 方法 (drawRect) 中 的 left、top、right、bottom 等 参数 的 含义 ， 其 他 方法 中 的 类 似 参数 的 含义 都 可 以 依 此 类 推 。 


另外 ， 在 使 用 Canvas 进 行 绘图 的 时 候 还 要 注意 ， 画 布 是 按照 程序 逻辑 的 先后 顺序 进行 泻 染 的 ， 因 此 底部 图 形 的 演 染 逻辑 放 在 前 面 ， 演 染 逻 辑 在 后 
2-30。 


的 图 形 则 会 层 层 履 盖 上 去 ， 使 用 范例 请 参考 代码 清单 


四 


代码 清单 2-30 


public class TestGraphicsView extends View { 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
private Paint mPaint = new Paint(); E 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public void onDraw(Canvas canvas) { D 

super.onDraw (canvas); 

// 设置 画布 颜色 

canvas.drawColor (Color. BLACK) ; 

// 设置 画笔 

mPaint.setAntiAlias (true) ; 

// BAB 

mPaint.setColor (Color. YELLOW) ; 

canvas.drawCircle(160, 160, 120, mPaint); 

// EX 

mPaint.setColor (Color.RED); 

canvas.drawRect(80, 80, 240, 240, mPaint); 

// dh Bl) 

mPaint.setColor (Color. GREEN) ; 

RectF rectf = new RectF(); 

rectf.left = 90; 

rectf.top = 100; 

rectf.right = 230; 

rectf.bottom = 220; 

canvas.drawOval(rectf, mPaint); 

// 画 多 边 形 

Path path = new Path(); 

path.moveTo (160, 110); 

path.lineTo(160-40, 110+80); 

path.lineTo(160+40, 110+80); 

path.close () ; 

mPaint.setColor (Color.BLUE) ; 

canvas.drawPath (path, mPaint); 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


D 


ERRER, TestGraphicsViewRAonDrawsitF RURAL. ABT. PARAS, inris 


2-13 所 示 ， 我 们 可 以 很 清楚 地 看 到 这 些 基础 几何 图 形 的 显示 效果 以 及 图 形 泻 染 的 先后 顺 


序 。 


t WI 全 上 二 9:32 
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w 


基础 几何 图 形 的 绘制 是 Android 图 形 系统 的 基础 知识 。 在 此 基础 之 上 ， 我 们 可 以 把 Android UI 控 件 结合 到 一 起 ， 开 发 出 丰富 多 彩 的 应 用 Ul 界 面 。 当 然 ， 我 们 还 可 以 运用 View 控 件 的 刷新 机 制 完 成 一 些 简 
的 图 形 动画 ， 相 关内 容 将 在 2.8.4 节 中 介绍 。 


Im 


284 ”常见 图 形变 换 


网 


常见 的 图 形变 换 包括 位 移 、 旋 转 、 缩 放 、 倾 斜 等 ， 其 中 ， 位 移 变换 在 开发 者 掌握 了 画布 坐标 系 等 基础 概念 的 情况 下 ， 实 现 起 来 是 比较 简单 的 ， 然 而 ， 旋 转 、 缩 放 以 及 倾斜 变换 则 涉及 变换 矩阵 
(Matrix) 的 概念 ， 这 里 需要 特别 解释 一 下 。 


Android 系 统 中 的 变换 矩阵 实际 上 是 一 个 3x3 的 和 矩阵， 专门 用 于 控制 图 形变 换 ， 和 矩阵 中 的 每 个 数值 都 有 其 特定 的 含义 。Android SDK 中 的 Matrix 类 位 于 android.graphics 包 下 ， 我 们 可 以 通过 setValue 
方法 直接 设置 旋转 矩阵 的 二 维 数 组 ， 但 是 这 种 用 法 比较 难 懂 ， 更 简单 的 用 法 是 使 用 M atrix 类 提供 的 方法 来 控制 旋转 矩阵 ， 比 如 setRotate 方 法 就 用 于 设 定 旋转 的 角度 。 代 码 清单 2-31 就 展示 了 Matrix 类 的 用 
法 。 


D 


代码 清单 2-31 


public class TestImageView extends View implements Runnable { 
private Bitmap star = null; 
private int starWidth = 0; 
private int starHeight = 0; 
private float starAngle = 0.0f; 
private Matrix starMatrix = new Matrix(); 
public TestImageView (Context context) { 
super (context); 
// 加 载 资源 
Resources res = this.getResources () ; 
star = BitmapFactory.decodeResource (res, R.drawable.star); 
// 获取 原始 图 片 宽 高 
starWidth = star.getWidth(); 
starHeight = star.getHeight (); 
// 开始 重 绘 视图 
new Thread(this).start(); 
} 
public void onDraw (Canvas canvas) { 
super .onDraw (canvas); 
// 重 置 旋转 矩阵 
starMatrix.reset(); 
// 设置 旋转 角度 
starMatrix.setRotate (starAngle) ; 
// 重 绘 旋转 的 图 形 
Bitmap starBitmap = Bitmap.createBitmap (star, 0, 0, starWidth, starHeight, starMatrix, true); 
canvas.drawBitmap (starBitmap, 0, 0, null); 


GOverride 
public void run() ( 
while (!Thread.currentThread().isInterrupted()) { 


try { 
Thread.sleep (100); 
starAnglet*; // 旋转 角度 

} catch (InterruptedException e) { 
Thread.currentThread().interrupt(); 


l 
// 通知 主线 程 更 新 图 像 
this.postInvalidate(); 


上 述 代码 中 的 TestlmageView 类 是 一 个 完整 的 重 绘画 布 视图 的 例子 。 首 先 ， 该 类 继承 自 View 基 类 ， 同 时 还 包含 了 一 个 线程 类 的 run 方 法 ， 在 该 方法 的 逻辑 中 ， 每 100ms 进 行 一 次 重 绘 ， 即 调 
postlnvalidate 方 法 通知 主线 程 更 新 图 像 。 其 次 ， 在 TestlmageView 类 的 构造 方法 中 ， 主 要 包含 了 资源 初始 化 的 逻辑 ， 这 里 程序 加 载 了 一 个 五 星 形状 的 图 像 资 源 文 件 。 另 外 ， 在 onDraw 方 法 中 ， 我 们 可 以 
看 到 starM atrix 变 换 矩 阵 的 常见 用 法 之 一 ， 即 通过 setRotate 方 法 设置 旋转 的 角度 。 该 程序 最 终 的 运行 效果 ， 就 是 画 出 了 一 个 绕 着 屏幕 左上 方 顺 时 针 旋 转 的 五 角 星 ， 如 图 2-14 所 示 。 


[D 


当然 ， 我 们 还 可 以 让 图 像 绕 着 某 个 中 心 点 旋转 ， 这 也 不 是 问题 ， 我 们 只 需要 对 onDraw 方 法 的 逻辑 稍 做 修改 即 可 ， 修 改过 的 逻辑 实现 如 代码 清单 2-32 所 示 。 


代码 清单 ”2-32 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onDraw(Canvas canvas) { 
super.onDraw (canvas) ; 
// 重 置 旋转 矩阵 
starMatrix.reset(); 
// 设置 旋转 中 心 


float transX = 100; 
float transY = 100; 
float pivotX = starWidth/2; 


float pivotY = starHeight/2; 
starMatrix.setRotate (starAngle, pivotX, pivotY); 
starMatrix.postTranslate(transX, transY); 

// 重 绘 旋转 的 图 形 


canvas.drawBitmap (star, starMatrix, null); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


让 图 形 绕 着 其 中 心 旋 转 ， 首 先 要 使 用 setRotate 方 法 设置 图 形 的 旋转 中 心 ， 然 后 再 使 用 postTranslate 方 法 把 | 
我 们 可 以 看 到 屏幕 上 出 现 了 一 个 不 断 自转 的 五 角 星 。 


[IR] 


形 平移 到 相应 的 位 置 ， 即 坐标 (transX, transY) 。 该 实例 的 运行 效果 如 


2-15 所 示 ， 


D 
D 
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2-14 旋转 的 五 角 星 
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(transX,:transY) 
d MN "E 


” (transX + pivotX, 
transY + pivotY) 


图 2-15 ”自转 的 五 角 星 
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当然 ， 除 了 旋转 之 外 ， 常 见 的 图 形变 换 还 包括 大 小 变换 、 倾 斜 变换 等 ， 限 于 篇 幅 ， 这 里 就 不 做 介绍 了 ， 有 兴趣 的 读者 可 以 参考 Matrix 类 文档 中 的 prescale、postscale、preSkew、postSkew 等 方法 。 
这 里 我 们 还 需要 注意 的 是 pre 和 post 系 列 方法 的 区 别 ， 带 有 pre 前 缀 的 方法 表示 此 变换 逻辑 需要 应 用 在 所 有 变换 逻辑 之 前 ， 而 带 有 post 前 缀 的 方法 则 表示 此 变换 逻辑 会 依次 往 后 排列 ， 因 此 代码 清单 2-28 中 的 
旋转 逻辑 也 可 以 使 用 代码 清单 2-33 中 的 代码 替代 。 


代码 清单 ”2-33 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onDraw(Canvas canvas) { = 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
starMatrix.setTranslate(transX, transY); 
starMatrix.preRotate (starAngle, pivotX, pivotY); 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
l 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


29 Android 动 画 效果 


适当 地 使 用 动画 效果 可 以 很 好 地 提升 Android 应 用 或 游戏 的 操作 体验 。 目 前 Android 系 统 支持 的 动画 效果 主要 有 两 种 ， 即 逐 帧 动画 (Frame Animation) 和 补 间 动画 (Tween Animation) 。 虽 然 ,在 
Android 3.0 以 后 的 版 本 中 还 引入 了 新 的 动画 系统 ， 但 是 目前 最 主流 的 动画 效果 还 是 这 两 种 。 


2.9.1 逐 帧 动画 (Frame Animation) 


E 


逐 帧 动画 类 似 于 GIF 动画 图 片 ， 即 按照 顺序 播放 图 片 。 我 们 通常 会 在 Android 项 目的 res/drawable/ 目 录 下 | 
签 中 依次 放 入 需要 播放 的 图 片 ， 并 设置 好 播放 的 间隔 时 间 ， 如 代码 清单 2-34 所 示 。 


定义 逐 帧 动画 的 XML 模板 文件 。 编 码 的 时 候 ， 需 要 在 动画 模板 文件 的 <animation-list/> 标 


代码 清单 2-34 


<animation-list 

xmlns:android="http://schemas.android.com/apk/res/android" 

android:oneshot="false"> 

<item android:drawable="@drawable/a001" android:duration="100"/> 

<item android:drawable="@drawable/a002" android:duration="100"/> 

<item android:drawable="@drawable/a003" android:duration="100"/> 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</animation-list> 


然后 ， 就 可 以 在 Activity 界 面 控制 器 的 逻辑 中 自由 使 用 了 。 需 要 注意 的 是 ， 逐 帧 动画 并 不 能 独立 使 用 ， 动 画 效果 的 显示 还 是 要 借助 于 ImageView 图 像 控 件 ， 简 单 地 说 ， 也 就 是 把 动画 效果 绑 定 到 对 应 的 
ImageView 图 片 对 象 上 。 假 设 这 里 的 ImageView 元 素 的 ID 值 ， 即 android: id 属性 值 为 img_frame_anim， 而 之 前 定义 的 动画 模板 文件 名 为 demo _ frame_anim.xml， 逐 帧 动画 的 使 用 范例 如 代码 清单 2-35 
所 示 。 


[R] 


代码 清单 2-35 


public class DemoAnimationActivity extends Activity [ 

ImageView iv; 

AnimationDrawable ad; 

protected void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
// 获取 对 应 图 片 的 ImageView 对 象 
iv = (ImageView) findViewById(R.id.img_frame_anim); 
// 设置 对 应 图 片 的 背景 为 动画 模板 文件 
iv.setBackgroundResource (R.drawable.demo frame anim); 
// 初始 化 动画 对 象 
ad = (AnimationDrawable) imageView.getBackground(); 
// 开始 动画 
ad.start(); 

} 

Public void onPause() { 
super .onPause () ; 
// 停止 动画 
ad.stop(); 

} 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


以 上 代码 的 逻辑 非常 简单 ， 我 们 可 以 重点 关注 AnimationDrawable 对 象 的 用 法 ， 即 如 何 使 用 start 和 stop 方 法 控制 逐 帧 动画 的 播放 和 停止 。 


2.9.2 补 间 动画 (Tween Animation) 


补 间 动画 与 逐 帧 动画 在 本 质 上 是 不 同 的 ， 逐 帧 动画 通过 连续 播放 图 片 来 模拟 动画 的 效果 ， 而 补 间 动 画 则 是 通过 在 两 个 关键 帧 之 间 补 充 渐变 的 动画 效果 来 实现 的 。 目 前 Android 应 用 框架 支持 的 补 间 动画 
效果 有 以 下 5 种 。 具 体 实现 在 android.view.animation 类 库 中 。 


: AlphaAnimation: 透明 度 (alpha) 渐变 效果 ， 对 应 <alpha/> 标 签 。 

: TranslateAnimation: 位 移 渐变 ， 需 要 指定 移动 点 的 开始 和 结束 坐标 ， 对 应 <ttanslate/> 标 签 。 
: ScaleAnimation: 缩放 渐变 ， 可 以 指定 缩放 的 参考 点 ， 对 应 <scale/> 标 签 。 

: RetateAnimation: 旋转 渐变 ， 可 以 指定 旋转 的 参考 点 ， 对 应 <totate/> 标 签 。 


: AnimationSet: 组 合 渐变 ， 支 持 组 合 多 种 渐变 效果 ， 对 应 <set/> 标 签 。 


补 间 动 画 的 效果 同样 可 以 使 用 XML 语言 来 定义 ， 这 些 动画 模板 文件 通常 会 被 放 在 Android 项 目的 resanim/ 目 录 下 。 比 如 ， 代 码 清单 2-36 中 就 定义 了 一 个 组 合式 的 渐变 动画 效果 。 


代码 清单 2-36 


<set xmlns:android="http://schemas.android.com/apk/res/android" 
android: interpolator="@android:anim/decelerate_interpolator"> 
<alpha 


android: fromAlpha="0.0" 
android: toAlpha="1.0" 
android:duration="1000" /> 
<scale 
android: fromXxScale=" c. Pim 
"ELO. 


android:toYScale- 
android:duration- ioo， 
android:pivotX 
android:pivotY-"50$" 

android:startOffset-"100" /» 


</set> 


以 上 补 间 动 画 有 两 个 效果 : 首先 ， 在 1 秒 (1000ms) 的 时 间 内 ， 透 明度 从 0 (完全 透明 ) 变 成 1 (不 透明 ) ; 同时 ， 大 小 从 原先 的 1/10 变 成 正常 大 小 ， 缩 放 的 中 心 点 是 元 素 的 中 心 位 置 。 假 设 以 上 动画 效 
果 的 模板 文件 名 为 demo_tween_anim.xml， 现 在 我 们 要 把 该 动画 效果 应 用 到 一 张 ID 为 img_tween_anim 的 图 片上 ， 实 现 方法 见 代 码 清单 2-37。 

代码 清单 2-37 

http://www. hzcourse .com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/.. 

ImageView iv = (ImageView) findViewById(R.id. img 1 tween | anim); 

Animation anim = AnimationUtils.loadAnimation (this, R.anim.demo | tween anim); š 

iv.startAnimation (anim) ; 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 

在 实际 项 目 中 ， 我 们 经 常 使 用 补 间 动 画 ， 原 因 是 补 问 动画 使 用 起 来 比较 方便 ， 功 能 也 比 逐 帧 动画 强大 不 少 ， 而 且 还 可 以 很 方便 地 进行 动画 到 加 ， 实 现 更 加 复杂 的 效果 。 实 际 上 ， 代 码 清单 2-36 中 的 


<set/> 标 签 对 应 的 就 是 AnimationSet 类 ， 即 “动画 集合 ”的 概念 ， 支 持 加 入 多 种 动画 效果 ， 
相关 的 类 都 归 类 在 android.view.animation 包 之 下 ， 大 家 可 以 参考 SDK 文 档 进行 进一步 学 习 。 


如 渐变 动画 (alpha) 、 大 小 动画 (scale) 


， 线 性 动画 (translate) 等 。 另 外 ， 在 Android 系 统 中 ， 所 有 与 动画 


至 此 ， 我 们 已 经 初步 了 解 了 如 何在 Android 系 统 中 使 
外 , 使 


2.10 Android 开 发 环境 


各 种 动画 效果 ， 包 括 逐 帧 动画 和 补 间 动画 。 显 而 易 见 的 是 ， 在 Android 平 台 之 上 ， 开 发 者 们 可 以 很 方便 地 使 F 
动画 效果 还 可 以 帮助 我 们 制作 出 简单 的 Android 游 戏 ， 更 多 与 Android 游 戏 开发 有 关 的 内 容 请 参考 本 书 第 13 章 。 


各 种 动画 效果 来 为 应 


产品 增色 。 此 


前 面 我 们 已 经 学 习 了 Android 系 统 中 最 重要 的 基础 概念 的 内 容 ， 那 么 接 下 来 就 要 开始 正式 进入 Android 应 用 的 实战 开发 阶段 。“ 工 欲 善 其 事 ， 必 先 利 其 器 ”， 因 此 ， 我 们 先 来 熟悉 Android 应 用 的 开发 环 
境 吧 。 
Android 应 用 的 开发 环境 是 基于 Eclipse 平台 的 ，Eclipse 的 强大 无 需 多 说 ， 它 当然 也 适应 于 Windows XP. Mac OS、Linux 等 多 种 操作 系统 。 另 外 ， 我 们 还 需要 安装 一 些 必 备 的 开发 工具 包 ， 所 需要 的 软 
件 见 表 2-8。 
表 2-8 ” Android 应 用 的 开发 环境 必 备 的 开发 工具 
软件 版 本 下 载 地 址 
Android SDK Android SDK 2.2 以 上 http://developer.android.com/sdk/index.html 
Java SDK JDK 1.6 以 上 http://java.sun.com 
Eclipse Classic 版 本 http://www.eclipse.org 
ADT 最 新 版 本 https://dl-ssl.google.com/android/eclipse/ 
2.40.1 开发 环境 的 搭建 


在 搭建 开发 环境 之 前 ， 我 们 先 来 介绍 一 下 Android 开 发 环境 的 几 个 重要 组 成 部 分 以 及 它们 的 安装 方式 。 


1.Android SDK 


Android SDK 的 安装 非常 简单 。 首先， 直接 打开 前 


发 现 android-sdk-windows 这 个 


你 会 录 ， 这 个 
示 的 安装 界面 。 接 下 来 ， 


=f; 


提 到 的 Android SDK 的 下 载 地 址 ， 下 载 最 新 的 android-sdk_r22-windows.zip 安 装 包 (对 应 Android 4.4.x 版 本 ) 
录 就 是 Android SDK 目 录 了 ， 你 可 以 把 它 复制 到 你 所 希望 的 位 置 并 重新 命名 ， 比 如 D: \Android; 然后 ， 打 开 SDK Manager.exe， 你 会 看 到 如 图 2-16 所 


单 击 “OK” 按 钮 让 下 载 过 程 继 续 就 可 以 了 。 系 统 会 自动 下 载 最 新 的 Android SDK 及 其 文档 和 例子 等 。 当 然 ， 这 个 过 程 是 很 漫长 的 ， 如 果 有 可 能 ， 建 议 从 已 经 下 载 过 的 


; 下 载 完 


毕 之 后 ， 在 电脑 上 解压 ， 


朋友 那里 复制 


+ Android SDK and AVD Manager 


Virtual devices 

Installed packages 

Aveilable packages | Platforn API Level CPUS ABI 
Settings " " E = 
About — 


APIs by Google Inc., Android API 10, revision 2 
APIs by Google Inc., Android API 11, revision 1 
APIs by Google Inc., Android API 12, revision 1 
APIs by Google Inc., Android API 13, revision 1 
arket Licensing package, revision 1 
MS5 Driver package, revision 4 
Narket Billing package, revision 1 
Adnob Ads Sdk package, revision 3 
IV by Google Inc., Android API 12, revision 2 
Found Dual Screen APIs by KIOCERA Corporation, Android AFI 8, 
revision | 
Found Dual Screen APIs by KYOCERA Corporation, android AFI 10, 
revision | 
Found Real3] by LGE, Android AFI 6, revision 1 
Found GALAXT Tab by Samsung Electronics., Android AFI 6, revision 
1 


M A valid Android Virtual Device. LÌ A repairable Android Virtual Device. 
X ån Android Virtuel Device that failed to load Click ‘Details’ to see the error. 


2-16 Android SDK 安 装 界面 
小 贴 士 : 由 于 国内 的 网 络 问 题 ， 建 议 大 家 使 用 VPN 来 访问 developer.android.com 站 点 ; 当然 也 可 到 本 书 官方 网 站 《https://github.com/jameschz/androidphp) 上 找到 “国内 Android 资 源 镜像 汇总 ”链接 进入 
下 载 。 
2.Java SDK 


Java SDK 的 安装 过 程 也 是 很 简单 的 ， 不 过 下 载 地址 可 能 有 点 难 找 ， 如 果 找 不 到 请 尝试 从 以 下 地 址 下 载 : http://www.oracle.com/technetwork/java/javase/downloads/index.html。 下 载 完 最 新 版 的 
JDK 版 本 之 后 ， 使 用 软件 自动 安装 即 可 。 要 注意 的 是 ， 在 安装 完毕 之 后 需要 设置 Windows 系 统 的 环境 变量 ， 如 图 2-17 所 示 。 


D: \Javal\jdki.6.0_18 
4 
Windows HT 
| C: MWINDOWSNsystem32:C: WINDOWS... 
PATHEXT .COM;. EXE: . BAT: . CMD: VES. VBE..... 
LEP Te AP a 


图 2-17 Java SDK 安 装 界面 


设置 完毕 之 后 ， 我 们 可 以 在 Windows 命 令 行 中 使 用 “java-version” 命 令 行 来 检测 JDK 是 否 安装 成 功 。 如 果 运 行 结果 如 图 2-18 所 示 ， 则 表示 安装 成 功 。 


OWS\syst en32\cad. exe 


Microsoft Windows KP [版 本 5.1.2690] 
«C» 版 权 所 有 1985-2001 Microsoft Corp. 


:\Documents and Settings\shagoo>java -version 
ava version "1.6.8 18" 
wJavaCIM> SE Runtime Environment Cbuild 1.6.0 18—-b875 
ava HotSpotXTM»? Client UM <build 16.0-b13, mixed mode, sharing? 


:NDocuments and Settings \shagoo> 


图 2-18 ”检测 JDK 是 否 安 装 成 功 


3.Eclipse 


Eclipse 开 发 工具 的 安装 也 是 非常 简单 的 ， 进 入 http://www.eclipse.org/downloads/ 页 面 ， 下 载 Eclipse Classic 最 新 版 本 的 ZIP 压 缩 包 ， 解 压缩 后 再 复制 到 相应 目录 ， 比 如 D: \Eclipse。 打 开 
eclipse.exe 就 可 以 看 到 以 下 界面 ， 如 图 2-19 所 示 。 


r [HP z<. os 


=m 


SE Outline $ ë 


| 如 outline is mt svailable 


| 民 Pvaklass @ Javadoc (9. Declaration E Coneale DS Ñ Losa | EG Proprare x QB r? Bry = Ç 
Aadraid 


图 2-19 Eclipse 界面 


由 于 前 面 已 经 安装 过 Java SDK， 所 以 直接 打开 eclipse.exe 就 会 看 到 以 上 界面 ， 否 则 打开 时 会 提示 错误 。 下 面 为 没有 使 用 过 Eclipse 的 朋友 大 致 介绍 一 下 Eclipse 的 操作 界面 : 最 上 面 的 那 一 排 文字 是 “ 选 
项 菜单 栏 ”， 包 括 几 乎 Eclipse 中 所 有 的 操作 ; “选项 菜单 栏 ” 的 下 面 那 排 是 常用 项 目的 “快捷 图 标 栏 ”; 左边 是 Package Explorer， 即 “项 目 文件 浏览 框 ”， 主 要 用 于 管理 项 目 代 码 ; 中 间 是 “代码 编辑 
框 ”， 我 们 在 这 里 编辑 代码 ; 右边 是 Outline “代码 大 纲 框 ”， 这 里 可 以 方便 地 进行 代码 概览 ; 右 下 方 则 是 “调试 信息 框 ”， 这 里 面包 括 Problems 错 误 提 示 框 、Console 调 试 信息 结果 框 等 。 


4.ADT 


实际 上 ，ADT (Android Development Tools) 是 Eclipse 开发 工具 的 一 个 插件 ， 其 安装 过 程 也 很 简单 : 首先 单 击 Eclipse 界 面 上 方 的 “Help” 菜 单 ， 然 后 选择 “Install New Software” 命 令 ， 接 着 
Æ "Work with” 输 入 框 输入 ADT 揪 件 地 址 “https://dl-ssl.google.com/android/eclipse”， 单 击 “Add” 按 钮 添加 插件 站 点 即 可 。 当 下 方 窗口 出 现 选项 列表 时 ， 单 击 选择 所 有 的 安装 选项 ， 然 后 按照 提示 


安装 即 可 ， 如 图 2-20 所 示 。 


安装 完成 后 ， 会 在 左上 方 的 “快捷 图 标 栏 ”中 出 现 ADT 的 快捷 图 标 ， 即 下 。 单 击 此 图 标 ， 系 统 会 自动 打开 “Android SDK and AVD Manager" (Android 虚 拟 设备 管理 器 ) 界面 ， 如 图 2-21 所 示 。 在 


这 里 我 们 可 以 创建 并 管理 我 们 所 需要 的 虚拟 设备 。 此 时 ， 右 边 的 “虚拟 设 配 列表 ”中 是 空 的 。 


在 真正 地 开始 创建 设备 之 前 ， 我 们 还 需要 配置 一 人 ADT 中 Android 的 SDK 位 置 ， 配 置 过 程 如 下 : 执行 “Window” 菜 单 中 的 “Preferences” 命 令 ， 然 后 选择 左边 的 “Android” 选 项 ， 然 后 在 右边 
的 “SDK Location” 中 选择 Android SDK 安 装 的 位 置 。 比 如 ， 之 前 我 们 把 Android SDK 安 装 到 D: \Android 目 录 下 ， 那 么 我 们 在 这 里 就 选择 该 目录 ， 如 图 2-22 所 示 。 


© Install 


Available Software 
Check the items that you wish to install. 


Work with: |httpz://dl-zzl. google. confandroid/eclipse/ v 


Find nore software by working with the "Available Software Sitaz" preferences. 


Hame Version 

=] [7] 200 Developer Tools 
[v] 5 Android DIMS 12. 0. 0. v201106281929-138431 
[1 4» Android Development Tools 12.0. 0. «201106281929-138431 
[v] 3» Android Hierarchy Viewer .0. 0. v201106261929-138431 
[7] XD» Android Tracevi ew 12. 0. 0. ¥201106281929-138431 


Select All Deselect All 4 itens selected 


Details 


[Z] show only the Latest versions of available software C] Hi de items that are already installed 
[7]Group items by category What is already installed? 

器 Show only software applicable to targei environment 

["]Contact all update sites daring install io find required software 


(?) 


图 2-20 ADT 插 件 安装 界面 


* Android SDE and AVD Manager 


Installed packages 
Aveilable packages 


© Preferences 


AY) Nane ( Target Fame | Platform | API Level CPU/ABI 


zu ~ Xo AYD available E ac 


sw A valid Android Virtual Device. by A repairable Android Virtual Device. 
X ån Android Virtual Device that failed to load Click ‘Details’ to see the error. 


图 2-21 Android 虚 拟 设 备 管 理 器 


Android 


E General 

[mE Android 
Build 
DDMS 
Editors 
Launch 
LogCat 


Android Preferences 


SDK Location: D:\Android | 


Note: The list of SDK Targets below is only reloaded once you hit ‘Apply’ or 'OK' . 


| Vendor 


Usage Stats 
B Ant 
[e Help 
H Install/Update 
[B Java 
E Maven 
ie Mylyn 
E Run/Debug 
国 Team 
B Usage Data Collector 
Validation 
E VindowBuilder 
E XML 


@ 


“Android 1.5. 
Android 1.6 


Android 2.1-updatel 


Android 2.2 
Android 2.3.1 


Android 2.3.3 


Android 3.0 
Google APIs 
Android 3.1 
Google APIs 
Android 3.2 
Google APIs 


Android Open Source Project | 


Android Open Source Project 
Android Open Source Project 
Android Open Source Project 
Android Open Source Project 
Android Open Source Project 
Android Open Source Project 
Google Inc. 

Android Open Source Project 
Google Inc. 

Android Open Source Project 
Google Ine. 


Restore Defaults 


图 2-22 配置 ADT 


Android 虚 拟 设备 管理 器 是 用 来 运行 和 调试 我 们 所 开发 的 Android 应 用 程序 的 ， 它 可 以 模拟 各 个 版 本 几乎 所 有 的 Android 设 备 。 如 果 你 要 添加 一 个 新 设备 ， 就 单 击 右边 的 “New” 按 钮 ， 并 按照 图 2-23 


配置 所 需要 的 设备 ， 最 后 单 击 “Create AVD” 完 成 创建 ， 结 果 会 在 “虚拟 设 配 列 表 ” 中 显示 ， 如 图 


2-24 所 示 。 


小 贴 士 : 这 里 需要 说 明 的 是 ， 考 虑 到 向 下 兼容 性 ， 本 书 的 Android 客 户 端 实例 都 是 在 较 老 的 Android SDK 2.2.x 版 本 下 开发 并 运行 的 。 不 过 经 笔者 测试 ， 本 书 所 有 的 实例 在 新 版 本 的 Android SDK (比如 4.x) 
下 开发 并 运行 也 是 没 问题 的 。 大 家 如 果 已 经 使 用 新 版 本 的 Android SDK 进 行 开发 ， 可 以 把 本 地 运行 环境 升级 上 去 ， 不 会 影响 基本 的 源码 学 习 和 使 用 。 


© Create new Android Virtual Device (AWD) 


Hame: Bnd ord 2.2 
Target: Android 2.2 — API Level Ë ee 


CEVABI: | ABM (armeabi) I 


SI Card: | 
size: | | [uis 图 
Orne Ds 


Snapshot: | 
C] Enabled 


(e) Built-in: HVGA x 


Property | Vadu | 
[S] Card support = 
Abstracted LEI density IBD 

Max VH application h... z4 


[Override the existing AVI with the sane name 


图 2-23 创建 虚拟 设备 


4 Android SDK and AVD Manager 


* À valid Android Virtual Device. DES repairable Android Virtual Device. 
X An Android Virtual Device that failed to load. Click 'Details' to see the error. 


图 2-24 ”虚拟 设备 创建 成 功 
下 面 简单 介绍 一 下 Android 虚 拟 设备 的 主要 配置 选项 。 

: Name: 虚拟 设备 的 名 称 。 

: Target: 设备 的 Android API 版 本 ， 考 虑 到 兼容 性 ， 这 里 选择 Android 2.2 的 API。 

- SD Card: 设备 的 存盘 大 小 。 

“ Skin: 设备 外 观 ， 我 们 可 以 选择 主流 的 设备 ， 也 可 以 直接 指定 设备 的 宽度 和 高 度 。 


: Hardware: 设备 硬件 ， 如 果 你 的 设备 需要 有 一 些 特殊 的 硬件 ， 可 以 在 这 里 进行 配置 。 当 然 ， 还 可 以 使 用 右 侧 的 “New” 按 钮 来 添加 所 需要 的 虚拟 硬件 设备 。 


图 2-24 所 示 的 就 是 创建 完毕 的 AVD 的 虚拟 设备 列表 界面 ， 大 家 可 以 看 到 这 次 在 右 侧 的 设备 列表 中 已 经 多 出 一 个 名 为 “Android_2.2” 的 AVD 虚 拟 设备 ， 我 们 可 以 选中 它 ， 然 后 单 击 右边 的 “Start” 按 
钮 ， 然 后 等 待 一 段 时 间 ， 即 可 看 到 虚拟 设备 界面 ， 效 果 还 是 很 不 错 的 ， 如 图 2-25 所 示 。 


图 2-25 ”成 功 运行 虚拟 设备 


当然 ， 如 果 你 觉得 虚拟 设备 的 速度 太 慢 ， 我 们 也 可 以 使 用 真 机 来 调试 。 其 实 ， 操 作 起 来 也 很 简单 ， 安 装 步骤 如 下 。 


1 ;安装 手机 的 驱动 ， 保 证 手机 在 Windows XP 上 可 以 被 识别 。 


打开 手机 的 “设置 ”， 然 后 选择 “应 用 程序 ”中 的 开发 选项 ， 打 开 “USB 调 试 ” 和 “允许 模拟 地 点 ”选项 。 


打开 Eclipse 中 的 DDMS， 在 左边 的 Devices 列 表 中 就 可 以 看 到 你 的 真 机 设备 ， 单 击 选中 它 ， 就 可 以 开始 在 真 机 上 进行 安装 和 调试 了 。 


之 后 ， 我 们 就 可 以 通过 USB 连 接线 把 手机 设备 与 开发 机 器 连接 起 来 ， 直 接 把 Android 应 用 程序 安装 到 手机 设备 上 进行 调试 。 实 际 上 ， 真 机 调试 是 正规 Android 应 用 程序 发 布 的 必要 步骤 ， 因 为 Android 的 
手机 设备 型 号 非常 多 ， 所 以 在 上 线 之 前 应 尽量 多 测 一 些 手机 设备 ， 保 证 Android 应 用 的 兼容 性 。 


前 面 我 们 已 经 把 Android 的 开发 环境 准备 好 了 ， 下 面 我 们 将 使 用 Eclipse+ADT 来 创建 自己 的 首 个 Android 项 目 ， 也 就 是 我 们 常 说 的 Hello World 项 目 ， 具 体 步骤 如 下 。 


LE 


打开 Eclipse 开发 工具 ， 单 击 左 上 方 的 “新 建 项 目 ” 菜 单 创建 一 个 项 目 ， 然 后 选择 “Android Project” 子 项 ， 单 击 “Next” 按 钮 ， 如 图 2-26 所 示 。 


2 在 接 下 来 的 新 建 项 目 界面 中 的 “Project Name” (项 目 名 ) 文本 框 中 填 入 项 目的 名 字 hello; 在 “Build Target” 选 项 组 中 选择 “Android 2.2”， 这 里 的 选项 应 该 和 前 面 建立 AVD 时 采用 的 
Android 版 本 保持 一 致 ， 在 “Package name” 文 本 框 中 填写 包 名 “com.app.hello”; Æ “Create Activity” 文 本 框 中 填 入 需要 建立 的 默认 Activity 类 名 HelloActivity， 如 图 2-27 所 示 。 


小 贴 士 : 以 下 的 “hello” 项 目 同 “Hello World” sm B. 


Hew Project 


Select a wizard 


c situ 
[type filter text 


& @ Jes 
ae Maven 
田 (> Examples 


Ej2-26 ”创建 Android 项 目 


£— New Android Project 


New Android Project 


Creates a new Android Project resource. 


Project nane: | hells 


Contents 

@)Creaie nev project in workspace 
CoCreste project Erom existing source 
(Use default location 


Lacstion: D: Eclipse Msworkepace/ Eells 


Crente project Erom existing sample 
Samples: fApillenes 
Build Targat 


Target Hane Vander Platforn 


Android Open Source Project 
Android Open Source Project 
Android Open Sources Project 
Android Open Sources Project 
Android Open Source Project 
Android Open Eoures FProjact 
Android Open Eoures Projact 
| Google APIs Google Ine. 

C] Android 3.1 Android Open 5ourra Project 
E] Google APIs Googla Ine 

C] Android 3.7 Android Open Soares Project 
[] Google APIs Google Ine 
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图 2-27 项 目 创建 界面 


小 贴 士 : 以 上 创建 Android 项 目的 过 程 是 基于 比较 早 的 ADT 12.0.0 版 本 ， 在 新 版 的 ADT 中 会 略 有 不 同 。 比 如 ， 在 ADT 20.0.0 以 上 的 版 本 中 ， 我 们 需要 选择 Eclipse 的 “New Project” 菜 单 中 的 “Android 
Application Project” 选 项 来 创建 Android 项 目 。 不 过 万 变 不 离 其 宗 ， 大 家 注意 填写 好 应 用 名 (Application Name) 、 项 目 名 (Project Name) 、 包 名 (Package Name) ， 并 选择 正确 的 Android SDKJ AK Pp T o 


步骤 3: 单 击 “Finish” 按 钮 ，ADT 会 自动 生成 代码 并 把 项 目 建 好 。 完 成 之 后 ， 我 们 就 可 以 在 Eclipse 界面 左边 的 “Package Explorer” 窗 口中 看 到 创建 完毕 的 名 为 “hello” 的 项 目 了 。 接 下 来 ， 我 们 试 
着 发 布 并 运行 此 项 目 。 右 键 单 击 hello 项 目 ， 在 快捷 菜单 中 执行 “Run As" > "Android Application” 命 令 ， 如 图 2-28 所 示 。 
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图 2-28 ”运行 hello 项 目 


步骤 4: Eclipse 会 帮助 我 们 自动 完成 代码 编译 工作 ， 并 安装 到 Android 模 拟 器 上 运行 ，hello 项 目的 最 终 运 行 效果 如 图 2-29 所 示 。 


图 2-29 ”hello 项 目 运行 效果 


至 此 ， 我 们 已 经 成 功 建立 了 自己 的 
要 组 成 部 分 。 首 先 ， 我 们 来 看 一 下 应 


首 个 Hello World 项 目 ， 虽 然 没 有 写 过 一 行 代码 ， 这 就 是 使 用 ADT 环 境 给 我 们 带 来 的 好 处 。 接 下 来 ， 我 们 就 以 Hello World 项 目 为 例 ， 分 析 一 下 Android 应 上 
的 基础 配置 文件 ， 也 就 是 AndroidManifest.xml 文 件 ， 见 代码 清单 2-38。 


的 几 个 主 


代码 清单 2-38 


<?xml version-"1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com. app. hello" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"8" /» 
«application android: icon="@drawable/icon" android: label="@string/app_name"> 
<activity android:name-".HelloActivity" 
android: label="@string/app_name"> 
<intent-filter> 7 
<action android:name="android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


器 


以 看 到 ， 项 目 应 用 配置 文件 AndroidManifest.xml 中 不 仅 声明 了 Hello World 应 用 的 package 名 、 版 本 号 android: version、 最 小 的 sdk 版 本 限制 android: minSdkVersion 等 ， 
元 素 里 面 声明 了 应 用 中 唯一 的 Activity， 也 就 是 HelloActivity 的 配置 信息 。 此 外 ， 在 hello 项 目的 配置 文件 中 ， 我 们 还 需要 注意 以 下 几 点 。 


还 在 <application> 


* package 名 就 是 应 用 安装 时 用 的 类 包 名 ,务必 保证 该 名 不 和 其 他 应 用 重 名 ， 否 则 安装 时 会 发 生 严 重 冲突 。 
<activity> 元 素 中 的 android: name 必 须 和 相关 的 Activity 类 对 应 上 ， 比 如 “.HelloActivity” 应 该 和 "com.app.hello.HelloActivity" 类 对 应 。 


<intent-filter> 元 素 用 于 决定 activity 的 调用 方式 ， 比 如 “android.intent.action.MAIN” 就 说 明 这 个 Activity 是 该 应 用 的 总 入 口 ， 一 个 应 用 有 且 只 能 有 一 个 MAIN 入 口 Activity。 


由 于 Hello World 项 目 比较 简单 ， 大 家 在 这 里 只 能 看 到 项 目 应 用 配置 文件 很 小 一 部 分 的 有 
Activity 之 外 的 其 他 重要 组 件 的 配置 方法 ， 以 及 关于 消息 过 滤器 <intent-filter> 的 完整 用 法 等 


法 ， 比 如 Android 应 用 的 基础 声明 、Activity 组 件 的 简单 配置 等 。 关 于 配置 文件 
， 我 们 都 将 在 实战 篇 中 的 7.1.1 节 中 详细 介绍 。 


他 更 高 级 的 用 法 ， 比 如 除 


L^ 


接 下 来 ， 打 开源 码 目录 src/ 下 的 com.app.hello 代 码 包 中 的 主要 界面 程序 的 Java 程 序 HelloActivity.java 的 代码 ， 如 代码 清和 
接着 ， 在 此 类 的 onCreate 接 口中 使 用 了 setContentView 方 法 设置 本 Activity 所 使 


和 2-39 所 示 。 该 类 的 代码 逻辑 比较 简单 ，HelloActivity 类 继承 了 Activity 基 类 ; 
的 layout 模 板 ; 最 后 ， 在 运行 的 时 候 ， 系 统 就 会 展示 出 对 应 的 UI 界 殖 


z 


代码 清单 2-39 


package com.app.hello; 
import android.app.Activity; 
import android.os.Bundle; 
public class HelloActivity extends Activity { 

/** Called when the activity is first created. */ 

GOverride 

public void onCreate (Bundle savedInstanceState) { 

super.onCreate (savedInstanceState); 

setContentView (R.layout.main); 


读 到 这 里 ， 也 许 大 家 会 有 疑问 ， 


目录 结构 如 图 2-30 所 示 。 


VRE 


2-30， 我 们 来 讲解 一 人 Android 项 目 


TE hello | 


中 常见 的 


录 结 构 。 


-i es Src | 
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虽然 我 们 设置 了 R.layout.main 模 板 ， 但 是 模板 文件 在 哪里 呢 ? 要 解决 这 个 问题 ， 我 们 需要 熟悉 一 下 Android 的 基本 目 


E Android 2.2 


mc assets 
| u^ res 


?[5) 


Ë= drawable-hdpi 
[= drawable-ldpi 
[= drawable-mdpi 
[£5 layout 


| X) main. xml 
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(=> values 


X| strings. xml 


录 结 构 ， 我 们 就 以 Hello World 项 目 为 例 ， 项 目的 


AndroidMani fest. xml 


^ [E] default. properties 
proguard. cfg 


42-30 ”Hello 项 目 基本 目录 


: hello/src/com.app.hello: 程序 包 目 录 ， 这 里 根据 前 面 新 建 项 目的 时 候 填写 的 “Package Name” 选 项 来 生成 应 用 程序 包 的 Namespace 命 名 空间 。 


- hello/gen/com.app.hello: 存储 ADT 自 动 生成 的 资源 映射 文件 R.java， 此 文件 内 的 静态 类 分 别 对 应 着 Android 不 同 的 资源 类 型 ， 而 类 中 的 静态 类 变量 就 表示 对 应 资源 的 id 标 识 ， 比 如 ，R.layout.main 对 应 
hello/res/layout/main.xml 布 局 文件 。 


- hello/res/drawable-hdpi: 图 片 以 及 泻 染 文件 存储 目录 ， 在 Android 2.1 之 后 ， 原 先 的 drawable 目 录 被 扩充 为 3 个 目 录 drawable-hdpi、drawable-ldpi 和 drawable-mdpi， 主 要 是 为 了 支持 多 分 状 率 ，drawable- 


hdpi 存 放 高 分 辩 率 图 片 ， 如 WVGA (480X800) , FWVGA (480X540) 。 


: hello/res/drawable-ldpi: 中 等 分 辨 率 图 片 存储 目录 ， 如 HVGA (320X480) 。 


- hello/res/drawable-mdpi: 低 分 辨 率 图 片 存储 目录 ， 如 QVGA (240X320) 。 
: hello/res/layout: 布局 文件 存储 目录 ， 这 里 就 是 存储 layout 模 板 的 地 方 了 。 


: hello/res/values: 配置 文件 存储 目录 ， 如 strings.xml、colors.xml 等 。 如 果 你 要 开发 Android 的 国际 化 程序 ， 可 以 在 这 里 为 不 同 的 地 区 所 支持 的 语言 设置 不 同 的 目录 ， 比 如 中 文 简体 hello/res/values-zh- 


ICN， 而 中 文 繁 体 则 为 hello/res/values-zh-tTW 。 

- hello/AndroidManifest.xml: 每 个 Android 项 目 都 必需 的 基础 配置 文件 ， 除 了 上 声明 程序 中 的 Activities、ContentProviders、Services 和 Intent Receivers， 还 可 以 指 定 permissions 和 instrumentations (安全 控制 
和 测试 ) 等 。 

- hello/proguard.cfg: 主要 用 于 Android 应 用 代码 的 安全 混 消 。 


理解 以 上 内 容 之 后 ， 可 以 尝试 着 动手 给 Hello World 项 目的 代码 做 一 些小 修改 ， 比 如 ， 调 整 一 下 打印 出 来 的 文字 ， 或 者 修改 一 下 布局 的 方式 等 。 这 样 不 仅 可 以 加 深 对 Android 项 目 开 发 的 印象 ， 还 可 以 帮 
助 大 家 快速 地 熟悉 Android 应 用 的 开发 工具 ， 为 后 面 的 项 目 实践 做 准备 。 


2.10.3 ”使 用 DDMS 调 试 工具 


在 完成 了 首 个 Hello World 项 目的 创建 之 后 ， 大 家 应 该 可 以 体会 到 在 Eclipse 加 上 ADT 的 开发 环境 中 进行 Android 代 码 开 发 是 一 件 多 么 方便 的 事情 。 而 实际 上 ，ADT 还 给 我 们 提供 了 一 个 非常 方便 的 调试 工 
具 ， 那 就 是 DDMS。 使 用 这 个 工具 ， 代 码 调试 工作 也 变 得 简单 起 来 。 我 们 只 需要 单 击 Eclipse 界 面 右 上 方 的 DDMS 按 钮 就 可 以 切换 到 DDMS 界 面 了 ， 如 图 2-31 所 示 。 
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2-31. DDMS 调 试 界面 


接 下 来 ， 我 们 按照 “从 左 到 右 ， 从 上 到 下 ”的 顺序 介绍 一 下 该 工具 中 的 几 个 主要 功能 板块 的 功能 和 使 用 。 


: Devices: 该 窗口 用 于 显示 所 有 设备 的 详细 信息 ， 这 里 的 emulator5554 就 是 模拟 器 设备 的 编号 ， 下 面 则 是 设备 运行 的 所 有 进程 的 列表 ， 单 击 相应 的 进程 还 可 以 进行 调试 、 截 屏 等 动作 。 


: Emulator Control: 这 里 主要 用 于 操控 一 些 模拟 器 的 行为 ， 比 如 设置 GPS 定位 信 


息 等 。 


: File Explorer: 本 窗口 是 Android 系 统 的 文件 浏览 器 ， 在 这 里 ， 我 们 可 以 浏览 设备 里 面 的 文件 目录 ， 比 如 ， 之 前 在 讲 Android 数 据 存储 的 时 候 提 到 过 可 以 使 用 DDMS 来 浏览 对 应 的 存储 文件 ， 讲 的 就 是 这 


个 窗口 的 功能 。 


“ LogCat: 用 于 打印 设备 的 调试 信息 ， 这 个 窗口 应 该 是 在 开发 过 程 中 最 经 常用 到 的 了 ， 这 里 的 信息 分 为 五 级 ， 分 别 对 应 上 面 的 V (VERBOSE) 


E (ERROR) 五 个 圆 形 的 按钮 。 此 外 ， 还 可 以 通过 单 击 这 些 按钮 来 过 滤 相 应 的 调试 信息 。 


~ D (DEBUG) I (INFO) . W (WARN) 、 


: Console: 控制 台 打 印 的 主要 是 操作 信息 ， 在 这 里 ， 可 以 查看 设备 的 运行 情况 ， 比 如 应 用 的 apk 包 是 否 安装 成 功 等 。 


在 这 些 功能 板块 中 ， 我 们 导 


人 在 调试 的 时 候 比 较 喜 欢 使 用 WARN 级 别 ， 
需要 切换 到 DDMS 就 可 以 调试 程序 了 。 以 上 是 笔者 本 人 的 一 些 使 用 


当然 ，DDMS 的 用 法 不 只 有 上 面 提 到 的 这 些 功能 ， 关 于 DDMS 的 使 用 心得 ， 大 家 应 该 在 Android 应 


点 介绍 一 下 LogCat 窗 | 


的 使 用 ， 


n 


为 开发 的 时 候 最 经 常 使 


到 的 就 是 它 了 。 在 Android 程 序 中 ， 我 们 可 以 使 用 android.util.Log 类 里 面 的 方法 来 打印 不 同 级 别 的 信息 ， 笔 者 个 


因为 INFO 以 上 的 信息 太 多 了 ， 不 利于 过 滤 ， 而 ERROR 又 太 严重 ， 经 常 和 一 些 Exception 混 起 来 。 另 外 ， 笔 者 个 人 还 非常 喜欢 直接 把 它 拉 到 开发 界面 中 去 ， 这 样 不 


心得 ， 如 果 你 觉得 不 错 的 话 不 妨 试 一 试 。 


的 开发 和 调试 中 注意 积累 。 另 外 ， 本 书 实战 篇 中 的 7.1.3 节 也 会 结合 实际 应 用 进一步 说 明 DDMS 工 具 


的 用 法 。 总 之 ， 学 会 如 何 灵活 地 使 用 DDMS 来 调试 Android 应 用 程序 是 Android 应 用 开发 中 必 不 可 少 的 知识 和 技巧 。 


241 Wes 


在 本 章 中 ， 首 先 我 们 学 习 了 Android 的 系统 框架 和 应 
Provider) ， 以 及 Android 中 一 些 常用 的 数 


试 的 方法 。 


框架 ， 然 后 熟悉 了 Android 的 四 大 核心 要 点 和 四 大 组 件 (活动 Activity、 服 务 Service、 广 播 接收 器 Broadcast Receiver、 内 容 提供 者 Content 
时 存 储 方式 。 随 后 ， 我 们 还 学 会 了 如 何 安装 和 配置 Android 的 开发 环境 ， 并 且 动 手 开 发 了 第 一 个 Android 应 


Hello World 项 目 ， 还 学 习 了 一 些 使 用 DDM S 进 行 调 


最 后 ， 建 议 大 家 回顾 一 下 本 章 的 所 有 知识 点 ， 如 果 感 觉 都 已 经 理解 掌握 了 的 话 ， 那 么 要 恭喜 ， 你 已 经 成 功 迈 出 成 为 Android 大 师 的 第 一 步 ; 当然 ， 如 果 你 感觉 思路 还 有 点 不 够 清晰 的 话 ， 请 回头 好 好 回 


顾 并 理解 一 下 本 章 的 内 容 ， 


983: “PHP 开发 准备 


因为 这 些 知识 对 你 以 后 继续 深入 地 学 习 Android 系 统 是 非常 重要 的 。 


通过 本 章 ， 读 者 将 快速 地 学 会 如 何 使 用 PHP 语 言 进 行 服务 端 开 发 。 当 然 ， 如 果 你 之 前 已 经 有 过 一 些 服务 端 开发 的 基础 ， 学 习 本 章 内 容 将 会 更 加 轻松 ; 然而， 如 果 你 以 前 一 直 专 注 于 客户 端 开发 ， 则 更 需 
要 仔细 阅读 本 章 的 内 容 ， 因 为 本 章 将 通过 讲解 PHP 语 言 引领 你 进入 服务 端 开发 的 世界 ， 并 理解 一 些 服务 端 开发 通用 的 方法 和 思路 。 


本 章 首 先 会 给 大 家 介绍 PHP 的 开发 基础 ， 以 及 一 些 面向 对 象 编程 的 技巧 ; 然后 紧 接着 给 大 家 介绍 PHP 开 发 环境 (Xampp) 的 搭建 和 一 些 其 他 主要 的 与 之 配套 的 服务 端 组 件 (Apache 和 MySQL) 的 基础 
EE; 最 后 还 会 介绍 一 个 强大 的 基于 Zend Framework 和 Smarty 类 库 的 PHP 框 架 : Hush Framework， 本 书 核心 的 “ 微 博 实例 ” 正 是 采用 这 个 PHP 框 架 ， 并 使 用 了 其 中 的 MVC 分 层 开发 的 思路 进行 开发 


3.14 PHP 开发 基础 


编写 本 章 之 前 ， 笔 者 在 考虑 一 个 问题 ， 那 就 是 “如 何 把 一 本 书 的 内 容 压 缩 到 短 短 的 一 章 中 ”。 这 确实 是 一 个 难题 ! 由 于 篇 幅 有 限 ， 本 书 会 尽量 避免 阐述 空洞 的 概念 ， 使 用 最 简洁 明了 的 语言 和 易于 理解 
的 代码 范例 ， 来 帮助 大 家 以 最 快 的 速度 认识 和 了 解 PHP 的 开发 思路 。 


3.1.1 PHP 语言 简介 


PHP (Hypertext Preprocessor) 是 目前 最 流行 的 服务 端 脚本 语言 之 一 。 近 年 来 ， 随 着 互联 网 的 飞速 发 展 ， 使 用 PHP 语 言 进行 互联 网 应 用 开发 也 变 得 逐渐 火热 起 来 ， 其 特点 是 简单 、 快 速 、 灵 活 ， 主 要 
应 用 于 各 大 门户 网 站 、 主 流 CMS 平 台 以 及 Web 2.0 网 络 应 用 中 ， 包 括 Google、Yahoo、Facebook、Zynga 在 内 的 互联 网 巨头 们 也 都 大 规模 地 使 用 PHP 作 为 其 主要 的 编程 语言 。 


那么 ，PHP 究 竟 能 用 来 做 什么 呢 ? 一 般 来 说 ，PHP 在 实际 项 目的 应 用 过 程 中 有 以 下 两 种 主要 的 使 用 方式 。 


1. 用 于 后 台 脚 本 编程 ， 即 以 命令 行 (CL) 的 方式 执行 


由 于 PHP 的 语法 和 Linux Shell 语 言 有 点 类 似 ， 而 使 用 起 来 却 要 比 Shell 强 大 且 方 便 得 多 ， 所 以 我 们 经 常 使 用 PHP 作 为 后 台 可 执行 脚本 的 解决 方案 。 这 种 方式 下 的 PHP 脚 本 ， 我 们 也 常 称 之 为 
CLI (Command-Line Interface) 脚本 。 


2. 用 于 网 络 应 用 编程 ， 即 以 mod _php 或 fastCGI 的 方式 执行 


简单 说 就 是 用 于 开发 网 站 或 者 互联 网 应 用 ， 这 也 是 PHP 最 主要 的 使 用 方式 。 在 这 种 方式 中 ，PHP 经 常 和 其 他 的 一 些 服务 端 组 件 结合 使 用 ， 比 如 在 著名 的 LAMP 架 构 里 ，PHP 就 是 与 Apache 服 务 器 、 
MySQIl 数据库 组 成 了 互联 网 应 用 服务 端 开 发 的 铁 三 角 。PHP 的 这 种 使 用 方式 通常 被 称 为 网 络 (Web) 脚本 模式 。 


小 贴 士 : LAMP 即 Linux、Apache、MYSQL 以 及 PHP/Per/Python 相 结合 的 服务 端 解决 方案 ， 也 是 目前 最 强大 的 互联 网 应 用 解决 方案 之 一 ， 占 据 了 全 球 的 网 站 70% 以 上 的 市 场 。 简 单 易 用 、 性 能 强劲 、 完 全 
免费 这 三 个 特点 是 LAMP 广 受 欢迎 的 原因 。 


3.1.2. PHP 语法 简介 


了 解 过 PHP 语 言 的 用 途 ， 接 下 来 我 们 来 看 看 如 何 使 用 PHP。 首 先 ， 来 学 习 一 下 PHP 基 本 语法 中 的 重点 部 分 ， 以 下 就 是 “精简 版 ”的 PHP 语 法 总 结 。 当 然 ， 如 果 读 者 已 经 有 过 一 些 其 他 主流 语言 的 编程 经 
验 ， 比 如 Java、C++ 等 ， 那 么 笔者 建议 学 习 时 ， 可 以 将 PHP 的 语法 与 这 些 已 经 比较 熟悉 的 语言 进行 对 比 学 习 ， 这 样 会 事半功倍 。 


1. 规 范 


PHP 代 码 部 分 需要 用 “<? php.….? >” 符 号 框 起 来 ， 这 也 表明 你 可 以 把 PHP 代 码 块 嵌入 到 HTML 代 码 的 任何 位 置 ， 这 种 用 法 类 似 ASP 或 者 JSP。 


2. 注 释 


PHP 中 单行 注释 以 “//” 或 者 “#” 符 号 开始 ， 多 行 注释 使 用 “/*.…*/” 符 号 框 起 来 ， 这 点 综合 了 Perl、C++ 以 及 Java 语 言 的 用 法 。 


3. 变 量 


PHP 的 所 有 变量 都 以 “$” 符 号 开始 ， 变 量 的 命名 规则 与 C+ + 和 Java 语 言 的 标准 基本 相同 ， 例 如 : $_user 是 正确 的 ，$@user 就 是 错误 的 。 另 外 ， 由 于 PHP 是 解释 性 语言 ， 具 有 弱 类 型 性 ， 所 以 PHP 的 变 
量 不 需要 声明 类 型 ， 这 点 与 Jjava 和 C++ 这 些 编译 型 的 强 类 型 语言 是 不 同 的 。 


4. 常 量 


PHP 使 用 define 函 数 来 定义 常量 ， 这 点 类 似 于 C 和 C+ + 语言 。 常 量 名 我 们 一 般 都 会 使 用 全 大 写 的 字母 ， 比 如 “define ('CONSTANT', $constant) ; ”这 行 代码 就 定义 了 一 个 值 为 gconstant 的 
CONSTANT 常 量 。 


5. 函 数 


自 定义 PHP 的 函数 必须 包含 function 关 键 字 ， 比 如 “function hello () {http://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/…}”。 此 外 ，PHP 语 言 的 自 带 函数 库 是 非常 强大 的 ， 这 点 大 家 可 以 在 日 后 使 用 中 慢 慢 体会 。 


定义 PHP 类 的 方法 和 Java 基 本 一 致 ， 比 如 “public class User{http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...)" . 53 
在 PHP 5 发 布 后 ，PHP 的 面向 对 象 功 能 越 加 强大 ， 具 体 可 参考 3.1.4 节 的 内 容 。 


外 


7. 允 许 文 件 中 包含 文件 


在 PHP 中 允许 包含 其 他 的 PHP 文 件 ， 这 样 方便 了 我 们 进行 代码 的 封装 ， 一 般 来 说 使 用 require 和 include 方 法 来 包含 。 如 果 要 避免 重复 包含 的 问题 ， 则 可 以 使 用 require_once 和 include_once 方 法 。 


8. 命 名 空间 


对 于 大 型 的 项 目 来 说 ， 命 名 空间 (Namespace) 的 功能 还 是 非常 必要 ， 使 用 命名 空间 可 以 减少 因为 类 名 或 者 函数 名 相同 所 带 来 的 风险 。 在 PHP 的 新 版 本 中 (PHP 5.3) ， 已 经 支持 namespace 语 法 ， 比 


如 “namespace Core\Lib1” , 


事实 上 ，PHP 的 语法 源 自 Perl 语 言 ， 并 融合 了 Java 和 (语言 的 部 分 优点 ， 对 于 有 一 定编 程 基础 的 开发 者 来 说 上 手 非常 快 。 首 先 ， 我 们 来 观察 一 个 PHP 的 Hello World 程 序 ， 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 


<?php 

// 打印 字符 串 

echo "Hello World"; 
2> 


从 这 段 代 码 中 我 们 可 以 看 到 一 个 标准 PHP 脚 本 的 写法 、 打 印字 符 串 的 方法 echo， 以 及 单行 注释 的 写法 。 


小 贴 士 : 在 实际 开发 时 ， 我 们 经 常 把 PHP 文 件 最 后 的 “? >” 符 号 去 掉 ， 因 为 这 样 写 不 仅 不 会 影响 PHP 的 语法 解释 ， 还 可 以 避免 一 些 由 于 编辑 器 在 文件 的 末尾 处 自动 加 上 特殊 字符 ， 从 而 影响 PHP 解 释 和 
输出 的 问题 。 


接 下 来 ， 我 们 来 分 析 代 码 清单 3-2 中 的 PHP 的 程序 范例 。 代 码 逻 辑 非常 简单 ， 最 前 面 定义 了 一 个 名 为 “USERNAME” 的 常量 ， 接 着 定义 了 一 个 函数 jsJjames () 用 于 判断 输入 的 参数 是 否 等 
于 “James”， 最 后 打印 函数 的 测试 结果 。 很 显然 这 段 代码 的 运行 结果 是 false， 因 为 传 入 值 和 比较 值 的 大 小 写 是 不 一 样 的 。 


代码 清单 3-2 


<?php 
// 常量 定义 
define ('USERNAME', "James"); 
// HEX 
function isJames ($username) { 
if (USERNAME == $username) { 
return true; 


return false; 
l 
// 打印 结果 


var dump (isJames ("james") ) ; 
?> 


以 上 代码 包含 了 PHP 语 言 中 的 注释 、 变 量 、 常 量 以 及 函数 等 重要 语法 的 使 用 方法 ， 大 家 可 以 烷 试 在 本 地 运行 该 脚本 。 运 行 方法 很 简单 ， 直 接 使 用 php 可 执行 文件 执行 即 可 ， 比 如 该 php 文 件 名 为 
demo1.php， 用 户 直接 在 系统 命令 行 窗口 中 输入 “php demo1.php” 并 运行 即 可 。 当 然 ， 在 此 之 前 我 们 还 必须 把 php 可 执行 文件 的 路 径 加 入 到 系统 环境 变量 中 去 ， 否 则 系统 可 能 提示 找 不 到 php 命 令 。 代 
码 清单 3-2 的 运行 结果 如 图 3-1 所 示 。 


C:\FINDOFS\system32\cad. exe 


D: workspace \php\basic>php demol.php 
hool<false> 


D: workspace \php ‘bas ic > 


图 3-1 代码 清单 3-2 的 运行 结果 


3.1.3 ”PHP 开发 起 步 


通过 3.1.2 节 的 学 习 ， 我 们 大 致 了 解 了 PHP 的 基本 语法 ， 本 节 我 们 将 进一步 认识 PHP 语 言 。 首 先 ， 我 们 来 看 看 PHP 语 言 的 几 个 特色 ， 也 就 是 它 和 其 他 语言 不 大 一 样 的 地 方 。 


1. 预 定义 变量 


PHP 提 供 大 量 的 预定 义 变量 ， 准 确 来 说 应 该 是 预定 义 “ 数 组 ”变量 ， 用 于 存储 来 自 服务 器 、 运 行 环境 和 输入 数据 等 动态 信息 ， 不 同 于 其 他 语言 使 用 对 应 的 使 用 类 包 或 者 方法 来 获取 的 方式 ， 相 对 来 说 
PHP 的 这 种 方式 更 加 简单 直接 。 表 3-1 中 列 出 了 PHP 语 言 中 比较 重要 的 预定 义 变量 。 


表 3-1 PHP 的 重要 预定 义 变量 


变量 名 环境 作用 

$GLOBALS 一 引用 全 局 作用 域 中 可 用 的 全 部 变量 
$_SERVER 一 服务 器 和 执行 环境 信息 

$ GET Web HTTP GET 变量 

$_POST Web HTTP POST 变量 

$_FILES Web HTTP 文件 变量 ( 用 于 文件 上 传 ) 
$_COOKIE Web HTTP Cookies 

$_SESSION Web Session 变量 

$_REQUEST Web HTTP Request 变量 ( 包含 HTTP GET/POST ) 
$ ENV == 系统 环境 变量 
$http_response_header Web HTTP 响应 头 

$argc CLI 传递 给 脚本 的 参数 数目 

$argv CLI 传递 给 脚本 的 参数 数组 


以 上 这 些 预 定义 变量 都 是 我 们 在 开发 过 程 中 经 常 使 用 到 的 ， 用 法 并 不 复杂 且 已 在 表格 中 列 出 ， 但 是 需要 注意 的 是 它们 中 某 些 变量 的 使 用 环境 是 有 限制 的 ， 比 如 $_ GET. $ POST 以 及 $_ SERVER 变量 在 CHI 
模式 下 是 没有 作用 的 ， 因 为 CLI 不 运行 在 服务 器 环境 里 。 关 于 这 点 我 们 已 经 在 上 表 的 “环境 ”一 列 中 说 明了 ， 其 中 标注 Web 的 表示 只 有 在 网 络 脚本 模式 下 才能 使 用 ;CLI 表示 只 工作 在 CLI 脚 本 模式 下 ; 其 他 
的 预定 义 变量 在 两 种 模式 下 均 可 使 用 ， 但 是 数组 的 内 容 可 能 会 不 


可 


以 下 是 一 个 使 用 预定 义 变量 的 例子 ， 不 像 Java 还 需要 使 用 request.getParameter () 方法 逐个 获取 GET 参 数 ，PHP 会 直接 把 所 有 的 GET 参 数 全 部 放 到 预定 变量 $ GET 中 ， 我 们 可 以 直接 循环 打印 出 来 ， 
如 代码 清单 3-3 所 示 。 


代码 清单 3-3 


<?php 

$sp = "<br/>\n"; 

foreach ((array) $_GET as $k => $v) 
echo "GET $k : $v".Ssp; 


?> 


由 于 这 个 脚本 必须 在 Web 模 式 下 才能 使 用 ， 因 此 我 们 需要 把 以 上 代码 放 入 站 点 目录 下 ， 开 启 浏览 器 ， 


ss 


2.null、false、0 和 空 字符 串 之 间 的 关系 


j? | || php-demo/bssic ‘demi 


运行 结果 如 图 3-2 所 示 。 


php? s=1 &b=28&e=3 


图 3-2 ”代码 清单 3-3 的 运行 结果 


在 PHP 中 ， 如 果 一 个 变量 没有 赋值 则 为 null， 这 点 和 Java 类 似 ; 但 是 ，PHP 是 一 门 “ 弱 类 型 ”的 语言 ， 因 此 对 于 PHP 来 说 ，null 和 false、0 以 及 空 字 符 捉 之 间 的 关系 有 点 特殊 ， 如 代码 清单 3-4 所 示 。 


代码 清单 3-4 


<?php 

// null and 0 

echo "null==0 : "; 

echo var dump (null--0); 

// null and '' 

echo "null-—'' : "; 

echo var dump (null—''); 

// null and false 

echo "null—false : "; 
echo var dump (null==false) ; 
// null and 0 

echo "null—-0 : "; 

echo var dump (null===0) ; 

// null and '' 

echo "null—-'' ; "; 

echo var dump (null==="'); 
// null and false 

echo "null===false : "; 
echo var dump (null===false) ; 
?> 


以 上 脚本 的 运行 结果 如 图 3-3 所 示 。 我 们 来 分 析 一 下 结果 : 首先 ， 前 3 段 代 码 说 明了 在 PHP 中 null、false、0 和 空 字符 串 之 间 是 可 以 画 等 号 的 ， 这 是 因为 它们 在 PHP 都 属于 一 种 “ 非 ” 类 型 ， 其 他 


的 “ 非 ”类 型 还 包括 空 数组 等 ; 其 次 ， 看 后 3 段 代码 ， 我 们 又 可 以 发 现 ， 如 果 我 们 要 区 别 这 几 个 值 也 是 可 以 做 到 的 ， 在 PHP 中 我 们 使 


PHP 的 这 个 特性 ， 如 果 随 意 乱 


， 很 有 可 能 会 犯 一 些 低 级 错误 。 


> bool<true> 
ull==’’ =: bool<true> 
ull--false : bool<true> 
ull===0 : bool<false> 
ul bool<false) 
mnull===false : hool<false> 


mmm) B 


ID: \works pace \php bas ic > 


全 等 号 便 可 以 判别 出 它们 之 间 的 不 同 。 我 们 在 日 常 编码 时 一 定 要 注意 


图 3-3 ”代码 清单 3-4 的 运行 结果 


表 3-2 列 出 了 PHP 语 言 中 对 于 “ 非 ”类 型 的 汇总 信息 ， 大 家 在 使 


PHP 的 过 程 中 一 定 要 特别 注意 这 些 数 值 的 使 用 方法 。 


表 3-2 PHP 的 “ 非 ” 类 型 汇总 


作用 
当 变 量 未 被 赋值 ， 则 为 null 
布尔 类 型 
字符 串 " 和 "" 
空 数组 Array() 


3. 魔 术 变 量 和 魔术 方法 


最 初 PHP 魔 术 变量 的 出 现 主要 是 为 了 方便 开发 者 调试 PHP 的 代码 ; 当然 ， 我 们 也 可 以 利 


这 些 魔术 变量 来 实现 特殊 需求 。 在 写法 方面 ， 魔 术 变量 前 后 都 有 两 个 下 划 线 ， 接 下 来 让 我 们 来 熟悉 一 下 这 些 变 


包含 一 个 绝对 路 径 (如 果 是 符号 连接 ， 则 是 解析 后 的 绝对 路 径 ) 。 


: 返回 当前 文件 所 在 的 目录 (PHP 5.3.0 中 新 增 ) 。 如 果 用 在 被 包括 文件 中 ， 则 返回 被 包括 的 文件 所 在 的 目录 ， 等 价 于 dimame (_FILE_) 。 除 非 是 根 目录 ， 否则 目录 中 名 称 不 包括 末尾 的 余 


魔术 方法 主要 是 随 着 PHP 的 面向 对 象 特性 出 现 的 (也 就 是 在 PHP 5 之 后 ) ， 主 要 解决 的 是 PHP 在 面向 对 象 的 思想 中 所 遇 到 的 一 些 特殊 情况 ， 写 法 方面 和 魔术 变量 类 似 ， 魔 术 方 法 使 用 两 个 下 划 线 开头 ， 


量 。 
-LINE : 返回 文件 中 的 当前 行 号 ， 我 们 在 定位 错误 的 时 候 经 常用 到 。 
» FILE: 返回 当前 文件 的 完整 路 径 和 文件 名 。 自 PHP 4024, FILE 总 是 
DR: 
杠 。 
» FUNCTION : 返回 当前 函数 的 名 称 (PHP 4.3.0 中 新 增 ) 。 自 PHP 5 起 本 常量 返回 该 函数 被 定义 时 的 名 字 ， 大 小 写 敏 感 。 在 PHP 4 中 该 值 总 是 小 写字 母 的 。 
- CLASS : 返回 当前 类 的 名 称 (PHP 4.3.0 中 新 增 ) 。 自 PHP 5 起 本 常量 返回 该 类 被 定义 时 的 名 字 ， 大 小 写 敏 感 。 在 PHP 4 中 该 值 总 是 小 写字 母 的 。 
- METHOD : 返回 当前 类 的 方法 名 (PHP 5.0.0 中 新 增 ) 。 注 意 与 _FUNCTION_ 的 返回 有 所 不 同 ， 大 小 写 敏 感 。 
» NAMESPACE : 返回 当前 命名 空间 名 (PHP 5.3.0 中 新 增 ) 。 这 个 常量 是 在 编译 时 定义 的 ， 大 小 写 敏感 。 
接 下 来 学 习 常用 的 魔术 方法 。 


: Construct () : 通用 的 类 构造 函数 。 
" destruct () : 通用 的 类 析 构 函数 。 
: _get (string$name) : 当 试图 读 取 一 个 并 不 存在 的 类 属性 时 被 调用 。 


- set (string$name, mixed$value) : 给 未 定义 的 类 变量 赋值 时 被 调用 。 


:. call (string$name, array$arguments) : 当 调 用 一 个 不 可 访问 类 方法 (如 未 定义 或 不 可 见 ) 时 ，_ call () 会 被 调用 。 


- _callStatic (string$name, array$arguments) : 当 调用 一 个 不 可 访问 的 静态 类 方法 时 ，__callStatic () 方法 会 被 调用 。 


* toStrng () : 当 打印 一 个 类 对 象 时 被 调用 ， 这 个 方法 类 似 于 Java 的 toString 方 法 。 


-clone () : 当 类 对 象 被 克隆 时 调用 。 


: Sleep () : 持久 化 一 个 类 对 象 时 ， 如 果 _sleep O 方法 存在 则 先 被 调用 ， 然 后 才 执行 序列 化 操作 。 这 个 功能 可 以 用 于 清理 对 象 ， 比 如 你 有 一 些 很 大 的 对 象 ， 不 需要 持久 化 ， 这 个 功能 就 很 好 用 。 


- wakeup () : 与 _sleep O 相反 ， 在 反 和 持久 化 类 对 象 时 ， 如 果 存 在 _wakeup () 方法 ， 则 使 用 该 方法 预先 准备 对 象 数据 。_wakeup () 可 用 在 类 似 于 重新 建立 数据 库 连接 等 初始 化 操作 中 。 


-isset () : 当 对 未 定义 的 类 变量 调用 isset Q 或 empty () 时 ，_isset O 会 被 调用 。 


-  unset () : unset 一 个 对 象 的 属性 时 被 调用 。 如 : unset ($class->name) o 


* invoke () : 当 举 试 以 调用 函数 的 方式 调用 一 个 对 象 时 ，_ invoke O 方法 会 被 自动 调用 。 


: autoload () : 区 别 于 以 上 所 有 方法 ， autoload () 并 非 是 一 个 类 方法 ， 而 是 一 个 全 局 方法 。 在 实例 化 一 个 对 象 时 ， 如 有 果 对 应 的 类 不 存在 ， 则 该 方法 被 调用 ， 可 用 于 类 的 自动 加 载 。 


另外 ， 别 忘 了 所 有 的 魔术 方法 都 需 


代码 清单 3-5 


给 予 public 属 性 。 关 于 魔术 变量 和 魔术 方法 的 应 用 如 代码 清单 3-5 所 示 。 


<?php 
class ClassA { 
// 私有 变量 
private $secret; 
// 给 私有 变量 赋值 
private function setSecret () { 
$this-»secret = "my secrets"; 


} 

// 构造 函数 

public function _ construct () ( 
echo "CALL ". METHOD ."\n"; 
$this-»setSecret(); 


} 
// 析 构 函数 
public function _ destruct () { 


echo "CALL ". METHOD _."Nn"; 
I 
// 魔术 方法 _ get 
public function _ get ($name) { 
echo "CALL _ get:".$name."An"; 
} 
// 魔术 方法 set 
public function _ set ($name, $value) { 
echo "CALL  set:".$name.",".$value."An"; 


} 
// 魔术 方法 _ call 
public function 


call ($name, Sarguments) { 


echo "CALL call:".$name.",".print_r($arguments, true) ."\n"; 


$ 

// 魔术 方法 _ sleep 

public function sleep () { 
echo "CALL ". METHOD ."in"; 
$this-»secret = "unknown"; 
return array ("secret"); 


} 
// 魔术 方法 _ wakeup 


public function 


echo "CALL ". 


wakeup () ( 
METHOD ."An"; 


$this-»setSecret(); 


) 


$a = new ClassA () ; 
$a-»attrA = "valueA"; 
echo $a-»attrB; 
$a->hello (1,2,3); 

$b = serialize ($a); 
var_dump ($b) ; 


// 初始 化 ClassA 
// 赋值 不 存在 的 属性 attrA 
// 获取 不 存在 的 属性 attrB 
// 调用 不 存在 的 方法 hello() 
// 持久 化 ClassA 
// 打印 持久 化 后 的 对 象 


$c = unserialize ($b); 
var_dump ($c) ; 
?> 


// 反 持 和 久 化 ClassA 
// 打印 反 持 久 化 后 的 对 象 


以 上 程序 先 定义 了 一 个 类 ClassA， 此 类 定义 了 一 个 $secret 属 性 ， 还 定义 了 我 们 上 面 介绍 到 的 一 些 主要 的 魔术 方法 ， 接 下 来 执行 了 以 下 步骤 ， 我 们 来 逐一 分 析 。 


1) 初始 化 ClassA: 调 有 


赋值 不 存在 的 


属性 attrA: 调 


魔术 方法 _set () 。 


3) 获取 不 存在 的 属性 attrB: 调用 魔术 方法 _get () 。 


4) 调 


不 存在 的 方法 hello () : 调用 魔术 方法 _call () 。 


5) 持久 化 ClassA: 调 有 
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反 持久 化 ClassA: 调 上 


回收 对 象 : 调 


两 次 析 构 函数 _destruct () ， 原 因 


7) 最 后 


构造 函数 _construct () ， 并 对 $secret 变 量 赋值 。 


魔术 方法 _sleep () ， 并 隐藏 ysecret 变 量 的 值 。 


魔术 方法 _wakeup () ， 并 恢复 $secret 变 量 的 值 。 


是 这 里 产生 了 两 个 对 象 实例 ，$a 和 $c。 


该 程序 的 最 终 运 行 结果 如 图 


3-4 所 示 ， 大 家 可 以 结合 


面 的 分 析 来 思考 。 


C:\¥INDO¥S\system32\cnd. exe 


D: workspace \php\hasic>php demo5 .php 


CALL Classf:: construct 
CALL set:attrfi,valuefi 


CALL | get:attrB 
CALL _ call:hello,firray 


CALL Classfi:: sleep 


string(445 "0:6:" "Classfi":1:s:6: 'secret';s:7: unknoun";»" 


CALL Glassñ:: wakeup 
objectCXClassfi»d2 <1)> < 
["secret"]=> 
string(1@> “my secrets" 


_ destruct 
_ destruct 


D: \works pace \ohpNhbas ic > 


;代码 清单 3-5 中 的 print_r 方 法 的 功能 主要 用 于 打印 PHP 数 组 。 


记得 多 年 以 前 有 位 从 


Java 开 发 的 同 对 


操作 的 代码 ， 如 代码 清单 3-6 所 示 。 


代码 清单 ”3-6 


<?php 

Sarr = array(1,2,3); 

// 集合 用 法 

echo 'Sarr[0]:'.$arr[0]."\n"; 


// 栈 用 法 
array_push ($arr, 4); 


echo '$arr:'.print r($arr, true); 
array pop($arr); ` 

echo 'Sarr:'.print r($arr, true); 
// 列表 用 法 

array_push(Sarr, 4); 

echo TŠarr:'.print_r(S$arr, true); 
array shift ($arr); 

echo T$arr:'.print_r($arr, true); 
// 散 列 用 法 

$arr[3] = 5; 

echo 'Sarr[3]:'.$arr[3]."\n"; 
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从 代码 中 的 注释 可 以 看 出 ， 以 上 程序 分 别 模拟 了 集合 、 栈 ( 


曾经 问 过 我 这 样 一 个 问题 : “为 什么 PHP 的 数组 这 么 好 
题 ， 首 先 我 们 要 理解 一 点 : 对 于 PHP 来 说 ， 没 有 集合 (Set) 、 栈 (Stack) 、 列 表 (List) LARA! 


后 进 先 出 ) 


、 列 表 (先进 先 出 ) 以 及 散 列 数组 的 


图 3-4 ”代码 清单 3-5 的 运行 结果 


We? ”当时 我 觉得 不 以 为 然 ， 不 过 现在 回 过 头 来 想 想 ， 这 个 问 
(Hash) 的 概念 ， 


题 确实 值得 好 好 讨论 一 下 。 要 解决 这 个 问 


所 有 这 些 常 见 的 数据 结构 都 在 PHP 的 数组 里 面 实现 了 。 我 们 先 来 看 一 段 关 于 PHP 数 组 


法 ， 大 家 可 以 体会 一 下 ， 该 程序 的 运行 结果 如 图 


3-5 所 示 。 


C:\ WINDOWS \systen32\crd. exe 


D: workspace \php\Nbasic>php demo6.php 

Sarr l(@):1 

arr:firray 

€ 
[01 => 
[11 => 
[2] => 
[31 => 


Sarr:firray 


arr[31:5 


D: workspace sphp*bas ic > 


图 3-5 代码 清单 3-6 的 运行 结果 


之 前 我 们 讨论 的 都 是 最 为 简单 的 一 维 数组 ， 而 在 实际 项 目 中 我 们 经 常 使 用 的 是 其 他 组 合 形式 的 数组 ， 比 如 ， 与 数据 库 表 结构 所 对 应 的 “ 散 列 数组 列表 ”的 形式 ， 下 面 我 们 再 来 看 一 个 例子 ， 见 代码 清单 
3-7, 


代码 清单 3-7 


<?php 
// SECUOE 
Sarr = array ( 
array ( 
"name" => "James", 
"sex" => "M", 
"age" => "28" 
), 
array ( 
"name" => "Iris", 
"sex" => "F", 
"age" => "27" 
) 
l; 
2> 


<table border=1 cellspacing=1 cellpadding=5> 
<tr><td>Name</td><td>Sex</td><td>Age</td></tr> 


<?php foreach ($arr as $row) { ?> 

<tr><td><?=$row ["name" ] ?»«/td»«td»«?-$row ["sex"] ?></td><td><?=$row ["age"] ?></td></tr> 
<?php ) ?> 
</table> 


在 上 述 例子 中 ， 我 们 演示 了 一 个 “ 散 列 数组 列表 ”的 使 用 方法 ， 实 际 上 这 种 数据 结构 经 常 出 现在 我 们 从 数据 库 中 取出 数据 然后 展现 到 页 面 表格 中 去 的 情况 。 除 此 之 外 ， 从 本 例 中 我 们 还 可 以 学 到 如 何在 
PHP 中 嵌入 HTML 标 签 ， 当 然 这 已 经 是 一 种 最 古老 的 使 用 方法 了 ， 在 实际 项 目 中 我 们 经 常 使 用 一 些 其 他 的 模板 引擎 来 负责 展示 部 分 ， 比 如 Smarty 模 板 引擎 (我们 将 在 3.5 节 中 介绍 ) 。 最 后 我 们 来 看 一 下 本 例 
在 浏览 器 中 的 运行 效果 ， 如 图 3-6 所 示 。 


s (£3 ph php-demo/basic/demo7.php 


Name x Sex | Age 


James IM |28 
[ Iris Fm 27 


通过 以 上 的 介绍 和 实例 学 习 ， 相 信 大 家 对 PHP 的 数组 已 经 有 了 一 定 的 了 解 ， 这 种 融合 了 列表 、 散 列 、 栈 等 多 种 常用 数据 结构 的 “超级 工具 ”可 以 说 是 PHP 的 一 大 发 明 ; 当然 ，PHP 数 组 的 用 法 绝 不 仅仅 


图 3-6 ”代码 清单 3-7 的 运行 结果 


只 有 以 上 这 些 ， 通 过 日 后 继续 深入 学 习 ， 我 相信 你 会 越 来 越 喜欢 这 个 “编程 利器 ”的 。 


3.1.4 ”PHP 面 向 对 象 编程 


虽然 之 前 我 们 已 经 学 习 了 PHP 语 言 的 开发 基础 ， 但 是 应 用 这 些 知 识 来 开发 项 目 还 远 远 不 够 ， 因 为 我 们 在 实际 的 项 目 中 都 需要 使 用 “面向 对 象 ”的 写法 来 进行 编程 ， 如 果 只 懂得 基本 语法 却 没有 面向 对 象 
的 编程 思想 是 万 万 不 行 的 。 所 以 接 下 来 我 们 将 为 大 家 介绍 在 PHP 语 言 中 ， 我 们 是 如 何 使 用 面向 对 象 的 编程 思路 来 进行 开发 的 。 


其 实 PHP 语 言 的 面向 对 象 编程 思路 和 Java 非 常 相似 ， 对 象 (Object) 、 类 (Class) 、 抽 象 类 (Abstract Class) 、 接 口 (Interface) 以 及 MVC 三 层 封装 的 用 法 都 大 同 小 异 ， 由 于 篇 幅 限制 ， 相 同 的 地 
方 将 不 再 歼 述 ， 这 里 主要 给 大 家 介绍 一 下 不 同 的 地 方 ， 下 面 我 们 将 结合 面向 对 象 编程 思想 中 的 几 个 重要 概念 来 分 析 一 下 。 


1. 抽 象 性 


要 认识 面向 对 象 的 思想 ， 首 先 需要 理解 什么 是 对 象 。 对 象 是 面向 对 象 编程 的 基本 元 素 ， 对 象 可 以 是 我 们 需要 研究 的 任何 元 素 ， 可 以 是 具体 的 物品 ， 也 可 以 是 抽象 的 事物 。 比 如 我 们 在 研发 一 个 后 台 管理 
系统 时 ， 管 理 员 是 一 个 对 象 ， 后 台 权限 也 是 一 个 对 象 。 这 就 是 抽象 的 基本 思路 ， 就 这 点 来 说 ， 不 管 我 们 使 用 的 是 什么 语言 ， 思 考 方式 应 该 是 一 样 的 。 


此 外 ， 对 象 在 程序 代码 中 是 用 “类 ” (Class) 来 表示 的 ， 每 个 类 都 需要 具备 “唯一 性 ”的 特征 ， 在 大 部 分 语言 中 都 使 用 “命名 空间 ”来 解决 这 个 问题 ; 然而 对 于 PHP 来 说 ， 我 们 通常 使 用 一 种 “ 约 
Se" 或 者 “规范 ”来 解决 这 个 问题 ， 比 如 在 PHP 的 一 些 大 型 类 库 (如 Zend Framework) 中 我 们 通常 把 类 名 和 目录 名 对 应 起 来 ，Zend/Db/Exception.php 文 件 的 类 名 是 Zend_Db_Exception， 这 种 方式 在 
项 目 中 还 是 比较 实用 的 。 


2. 继 承 性 


继承 性 是 面向 对 象 思想 中 最 基础 、 最 重要 的 特点 之 一 ， 也 正 是 因为 对 象 的 继承 性 才 延 伸 出 了 “抽象 ”和 “封装 ”等 面向 对 象 的 设计 方法 。 在 PHP 语 言 中 我 们 同样 使 用 私有 (private) 、 保 护 
(protected) 和 公共 (public) 关键 字 来 设 定 类 、 属 性 和 方法 的 权限 ， 关 于 这 些 基础 概念 的 基本 用 法 大 家 可 以 到 网 上 收 罗 到 一 大 堆 ， 这 里 不 再 蓝 述 。 下 面 我 们 将 以 一 个 PHP 代 码 为 例 给 大 家 讲解 一 下 使 用 要 
领 ， 见 代码 清单 3-8。 


代码 清单 3-8 


// 基础 抽象 类 
abstract class Base_Customer { 
// 私有 属性 
private $ name = 
// 私有 方法 
Private function checkName (Sname) { 
return is_string ($name) ? Sname : false; 


[EM 


} 

// 保护 方法 

protected function formatName (Sname) { 
return (string) $name; 


/ / 公用 方法 
public function setName (Sname) { 
$this-» name = $this->_formatName ($name) ; 


/ / 公用 方法 
public function getName () { 
return $this->_checkName ($this->_name) ; 


š 

// 抽象 方法 ， 子 类 需要 实现 

abstract public function setPassword(); 
// 抽象 方法 ， 子 类 需要 实现 

abstract public function getPassword(); 


上 述 实例 代码 中 我 们 定义 了 一 个 名 为 Base_ Customer 的 用 户 抽象 基 类 ， 里 面 有 一 个 名 为 “$_name” 的 私有 属性 ， 表 示 用 户 的 名 字 ; 为 了 让 外 部 能 够 访问 这 个 属性 ， 我 们 添加 了 读 取 名 字 getName 和 设 
置 名 字 setName 两 个 public 方 法 ， 供 外 部 程序 调用 。 另 外 ， 此 类 还 有 一 个 private 方 法 checkName 用 于 确认 用 户 名 字 是 否 有 误 ， 一 个 protected 方 法 formatName 用 于 保证 名 字 正 确 性 。 在 代码 的 最 后 我 们 
还 定义 了 两 个 抽象 方法 ， 设 置 密 码 setPassword 和 取得 密码 getPassworqd 两 个 方法 ， 用 于 对 用 户 的 密码 进行 操作 ， 这 两 个 方法 都 需要 在 子 类 中 实现 的 。 从 以 上 代码 中 我 们 可 以 看 到 PHP 语 言 里 大 部 分 面向 对 
象 编程 的 写法 ， 大 家 可 以 好 好 理解 一 下 。 


3. 多 态 性 


多 态 性 是 指 相同 的 操作 或 函数 、 过 程 可 作用 于 多 种 类 型 的 对 象 上 并 获得 不 同 的 结果 ， 这 个 特性 进一步 增加 了 面向 对 象 编程 思想 的 灵活 性 和 重用 性 。 我 们 知道 ， 重 载 是 实现 多 态 性 最 常见 的 方法 ， 比 如 代 
码 清单 3-9 就 是 使 用 Java 语 言 来 使 用 重 载 的 实例 代码 。 


代码 清单 3-9 


class Demo{ 
// 成 员 变 量 
int a, b, c; 
// 构造 函数 
public Demo() {} 
// 重 载 构造 函数 
Public Demo (int a, int b, int c) { 


this.a = a; 
this.b = b; 
this.c = c; 


} 
// 成 员 方法 
int sum() { 
return a +b + c; 


} 

// 重 载 成 员 方法 

int sum(int d) { 
return a + b + c + d; 


} 


我 们 看 到 上 面 用 Java 语 言 实现 的 Demo 类 中 ， 构 造 方法 Demo 被 定义 了 两 次 ， 根 据 传 入 参数 的 不 同 ， 方 法 逻辑 也 有 所 不 同 ; 另外 ， 类 中 的 成 员 方法 Sum 也 被 定义 了 两 次 ， 同 样 可 以 根据 不 同 的 参数 来 处 
理 不 同 的 逻辑 。 但 是 这 是 Java 的 做 法 ， 在 PHP 中 我 们 也 可 以 这 样 做 吗 ?” 答 案 是 否定 的 ， 因 为 PHP 语 言 不 允许 出 现 相同 名 称 的 方法 ， 即 使 在 同一 个 类 中 。 那 么 我 们 应 该 怎么 做 呢 ? 看 看 代码 清单 3-10 中 是 怎么 
写 的 吧 。 


代码 清单 3-10 


class Demo ( 

// 成 员 变量 

public $a, $b, $c; 

// 构造 方法 

public function Demo ($a = 0, $b = 0, $c = 0) { 
if ($a) $this->a = $a; 
if ($b) $this->b = $b; 
if ($c) $this->c = $c; 


} 
// 成 员 方法 
public function sum ($d = 0) í 
if (Sd) { 
return $this->a + $this->b + Sthis->c + $d; 
) else ( 
return $this->a + $this->b + Sthis->c7 
} 


我 们 可 以 看 到 ， 以 上 的 PHP 代 码 同样 实现 了 一 个 Demo 类 ， 此 类 含有 和 前 面 Java 版 的 Demo 类 同样 的 成 员 变 量 ， 却 只 有 一 个 构造 方法 Demo 和 成 员 方 法 sum; 但 是 有 趣 的 是 ， 通 过 对 这 两 个 方法 的 逻辑 分 
析 ， 我 们 会 发 现 这 里 同样 根据 参数 的 不 同 实现 了 不 同 的 逻辑 。 这 是 为 什么 呢 ? 答案 其 实 很 简单 ， 就 是 因为 PHP 人 允许 设置 参数 的 默认 值 。 这 种 PHP 特 有 的 功能 帮助 我 们 用 另外 一 种 方式 实现 了 多 态 性 。 


以 上 我 们 介绍 的 PHP 面 向 对 象 编程 的 基础 知识 ， 需 要 大 家 好 好 理解 一 下 ， 因 为 在 后 面 我 们 即将 给 大 家 介绍 的 微 博 应 用 实例 中 ， 这 些 用 法 将 会 被 广泛 使 用 ; 另外， 在 本 章 最 后 介绍 的 Hush Framework 框 
架 中 我 们 也 会 接触 到 这 些 用 法 。 当 然 ， 培 养 成 熟 的 面向 对 象 的 编程 思想 绝 不 是 一 朝 一 夕 的 事情 ， 需 要 大 家 在 学 习 的 时 候 边 实践 边 思考 ， 最 好 能 阅读 一 些 比较 优秀 的 代码 ， 当 然 本 书后 面 将 要 给 大 家 介绍 的 微 
博 项 目 实例 代码 也 是 个 很 不 错 的 面向 对 象 编程 的 代码 范本 ， 如 果 大 家 能 通过 本 书 将 其 理解 透彻 ， 绝 对 会 受益 菲 浅 。 


3.1.5 ”PHP 的 会 话 


业内 常 说 “不 理解 会 话 (Session) 的 概念 就 等 于 不 懂得 PHP 网 络 编程 ”。 当 然 ， 这 里 讲 的 是 PHP 语 言 用 于 互联 网 编程 的 时 候 。 因 为 HTTP 协 议 是 无 状态 的 ， 所 以 每 次 请 求 结 束 后 ， 变 量 和 资源 就 被 回收 
了 ， 那 么 我 们 如 何 保存 一 些 “ 持 久 ”的 信息 呢 ? 比 如 在 用 户 登录 之 后 ， 系 统 需要 把 用 户 登录 的 信息 保存 下 来 ， 在 整个 应 用 或 者 站 点 里 面 使 用 。 也 许 你 会 想到 使 用 数据 库 来 保存 ， 当 然 这 确实 是 一 种 解决 方 
案 ， 但 是 这 些 数据 大 部 分 属于 临时 数据 ， 用 户 退 出 登录 之 后 就 没有 用 了 ， 如 果 使 用 数据 库 不 仅 浪费 资源 ， 而 且 还 需要 定期 清理 ， 相 当 麻烦 。 为 了 解决 这 个 问题 ，PHP 专 门 为 我 们 提供 了 会 话 模块 ， 来 保存 这 
些 临 时 的 用 户 数据 。 


和 大 部 分 的 语言 环境 一 样 ，PHP 的 Session 机 制 不 是 非常 复杂 ， 客 户 端 只 需要 保存 一 个 会 话 ID， 即 Session ID， 每 次 会 话 请 求 都 会 把 这 个 Session 1D 传 给 服务 端 ， 并 获取 服务 端 接口 处 理 完 的 数据 ， 整 个 
过 程 如 图 3-7 所 示 。 


图 3-7 ”PHP 的 Session 机 制 


PHP 默 认 的 会 话 存储 方式 是 文件 存储 ， 数 据 会 被 保存 到 服务 器 本 地 的 session.save_path 参 数 设 定 的 目录 中 (此 参数 位 于 php.ini 本 置 文 件 ) 。 使 用 的 时 候 ， 首 先 需要 调用 session_start 方 法 开启 一 个 新 的 
Session， 然 后 直接 使 用 PHP 预 定义 变量 $ SESSION 来 进行 读 取 和 存储 操作 ， 在 请 求 结束 时 系统 会 把 修改 过 的 会 话 值 保存 到 存储 器 中 。 示 例 用 法 如 代码 清单 3-11 所 示 。 


小 贴 士 : php.ini 是 PHP 的 环境 配置 文件 ， 在 Linux 系 统 下 一 般 会 被 放 在 /etc/php.ini 目 录 下 。 该 文件 几乎 包含 了 PHP 运 行 环境 所 需 的 所 有 配置 ， 也 是 我 们 必须 学 习 的 内 容 之 一 ， 由 于 篇 幅 原因 ， 本 书 不 做 详 
细 讲 解 。 具 体 配置 参数 可 直接 参考 官方 文档 ， 地 址 如 下 http://cn.php.net/manual/zh/ini.list.php。 


代码 清单 3-11 


<?php 

session_start () 7 

// 初始 化 计数 器 变量 Scount 

$count = isset($ SESSION['count']) ? $ SESSION['count'] : 0; 
// 计数 器 依次 递增 

$_SESSION['count'] = ++$count; 

/7 打印 计数 器 值 

echo $count; 


前 面 的 会 话 实例 实现 了 一 个 简单 的 计数 器 ， 逻 辑 很 简单 ， 大 家 参照 着 注释 就 可 以 很 快 读 伐 。 这 里 需要 注意 的 是 ，Session 机 制 仅 适用 于 有 服务 器 的 网 络 环境 中 ， 在 以 命令 行 (CL) 脚本 运行 的 情况 下 是 
不 起 作用 的 。 另 外 ， 我 们 可 以 看 到 该 计数 器 程序 的 有 效 代码 只 有 4 行 ， 这 也 从 一 个 侧面 反映 了 PHP 语 言 的 简单 高 效 。 


当然 我 们 这 里 讨论 的 仅仅 是 比较 简单 的 Session 使 用 场景 ， 对 于 相对 比较 大 型 一 点 的 网 络 应 用 来 说 ，Session 的 使 用 就 不 是 这 么 简单 了 。 比 如 我 们 要 在 多 台 应 用 服务 器 之 间 共 享 Session， 那 就 不 能 把 
Session 信 息 存 放 在 本 地 了 ， 这 时 候 我 们 可 能 需要 把 session 集中 存储 在 某 个 公用 的 中 间 件 里 ， 比 如 数据 库 或 者 缓存 服务 器 等 。 好 在 PHP 给 我 们 提供 了 Session 回 调 接口 来 帮助 我 们 控制 session 的 存储 方式 ， 
实例 代码 请 参考 代码 清单 3-12。 


代码 清单 3-12 


<?php 
class SessionHandler ( 
protected $savePath; 
protected $sessionName; 
public function _ construct() { 
session set save handler( 
array($this, "open"), 
array ($this, "close"), 
array ($this, "read"), 
array ($this, "write"), 
array ($this, "destroy"), 
array ($this, "gc") 
); 


public function open($savePath, $sessionName) { 
Sthis-»savePath = $savePath; 
$this-»sessionName = $sessionName; 
return true; 


) 

public function close() { 
// 关闭 Session iZ# 
return true; 

} 

public function read($id) { 
// 读 取 Session 4h 


} 
public function write ($id, $data) { 
// 存储 Session Zi 


} 
public function destroy ($id) { 
// 销毁 Session 逻辑 


public function gc($maxlifetime) { 


) 


// 回收 Session iH 


l 
// 使 用 Session X 
new SessionHandler () ; 


上 述 实例 中 ,我们 使 


= 
HE 


的 知识 ， 这 些 进 阶 知 


3.2 PHP 开发 环境 


前 面 我 们 已 经 学 习 了 PHP 编 程 语言 的 基础 知识 ， 接 下 来 我 们 来 了 解 PHP 的 开发 环境 。 在 此 之 前 ， 我 们 先 讨 论 一 下 PHP 的 开发 工具 。PHP 是 一 种 脚本 语言 ， 
么 严格 的 限制 ， 从 简单 的 Notepad 和 EditPlus 到 复杂 的 Zend studio 和 Eclipse 都 可 以 进行 PHP 开 发 ; 但 是 在 实际 项 目 
Eclipse 作为 PHP 编 程 开发 的 统一 工具 ， 如 此 一 来 ， 还 可 以 和 Android 应 


3.2.1 


让 Eclipse 支持 PHP 有 两 种 方式 ， 其 一 是 在 本 机 的 Eclipse 开发 工 


开发 环境 的 搭建 


session set save _handler75;k8 


识 我 们 会 在 9.1.2 节 中 给 大 家 做 进一步 的 介绍 。 


开发 使 


PDT， 下 载 地 址 为 : http://www.eclipse.org/pdt/downloads/, 


PDT 的 安装 方法 很 简单 ， 解 压 即 可 使 
然 ， 如 果 你 想 要 把 PHP 开 发 环境 和 Android 开 发 环境 合 为 一 体 也 是 可 以 的 ， 这 就 需要 我 们 先 下 载 PDT 解 压 安装 之 后 再 安装 ADT。 


。 但 要 注意 的 是 ， 如 果 你 的 开发 机 之 前 没有 安装 过 Java 运 行 环境 ，PDT 还 是 不 能 运行 的 ， 毕 竟 它 


3.2.2 ”安装 配置 Xampp 


和 Android 客 户 端 开发 不 同 ， 进 行 PHP 服 务 端 开发 ， 除 了 要 安装 语言 本 身 的 环境 之 外 ， 还 需要 安装 和 配置 服务 端 需要 的 组 件 ， 这 也 是 服务 端 开发 和 客户 端 开发 的 不 同 之 处 。 


有 很 多 ， 本 书 为 大 家 推荐 一 个 方便 实用 的 集成 开发 环境 套件 : Xampp。 该 套件 是 完全 免费 的 ， 它 集成 了 Apache 服 务 器 、MySQL 数 据 库 、PHP 语 言 以 及 PERL 语 


Xampp 的 下 载 地 址 非常 多 ， 利 


同一 个 开发 工具 ， 何 乐 而 不 为 呢 ? 


上 安装 一 款 名 为 PHPEclipse 的 插件 ; 不 过 现在 我 们 一 般 使 


看 写 了 PHP 的 Session 机 制 ， 通 过 这 种 方式 我 们 可 以 很 方便 地 控制 Session 的 存 取 逻 辑 来 满足 我 们 的 需求 ; 此 外 ， 这 也 是 我 们 优化 Session 机 制 时 必 


因此 就 语言 本 身 特 点 而 言 ， 对 开发 工具 没有 什 


另 一 种 方式 ， 也 就 是 直接 下 载 Eclipse 专门 为 PHP 开 发 者 定制 的 开发 工 


中 ,为 了 保证 编码 的 一 致 性 ， 以 及 代码 版 本 管理 的 方便 性 ， 我 建议 大 家 在 项 目 开发 时 使 


还 是 要 依靠 Eclipse 环境 (环境 搭建 过 程 可 参考 2.10.1 节 ) 。 当 


当然 ，PHP 的 集成 开发 环境 
言 等 我 们 常用 的 服务 端 开 发 工具 。 


搜索 引擎 可 找到 很 多 关于 “Xampp 下 载 ”的 链接 ， 大 家 选择 一 个 比较 官方 的 链接 点 击 下 载 即 可 。 当 然 在 本 节 中 我 们 只 会 和 


更 全 面 的 关于 Xampp 开 发 环境 套件 的 详细 内 容 ， 可 以 登录 官方 网 站 了 解 ， 网 址 为 : http://www.apachefriends.org/zh_cn/xampp.html, 


具 的 使 用 方法 ， 如 果 你 想 了 解 


点 介绍 这 个 工 


本 书 的 开发 环境 是 Windows， 所 以 在 下 载 完 Xampp 的 Windows 版 本 之 后 ， 我 们 需要 将 其 安装 到 一 个 便于 访问 的 目录 下 ， 比 如 D: \xampp 目 录 ， 其 中 包含 的 文件 如 图 3-8 所 示 。 


anonymous 


ape start. bat 
“DOS 批 处 理 文 件 
"KB 


D filezilla start. bat 


从 图 3-8 中 我 们 可 以 看 到 Xampp 还 提供 了 很 多 额外 的 配套 工 


在 Xampp 的 控制 台 界面 中 ,我们 可 以 看 到 前 两 排 分 别 是 Apac 


MS-DOS 批 处 理 立 件 


1 KB 


"I mysql stop.bat 
MS-D0S SL ET pt 
1 KB 


setup xampp. bat 
MS-DOS 批 处 理 文件 
1 KB 


"I apache_stop. bat 


MS-DOS HANEY 


1 KB 


filezilla Stop. bat 
MS-DOS 批 处 理 文件 
KB 


passwords, txt 
SE 


cgi-bin 
licenses 


phpMyAdmin 


catalina start. bat 
MS-DOS 批 处 理 文件 
1 KB 


mercury_start. bat 
MS-DOS 也 处 理 文件 


ere de. txt 


TKE 


xampp start. exe 
start and stop X 
Apache Friends 


= 
= 
= 
= 
m): 
gz 


图 3-8 Xampp 目 录 下 包含 的 文件 


， 我 们 先 不 看 这 些 工 


入 “http://localhost” 地 址 就 可 以 看 到 Xampp 的 管理 界面 了 ， 如 图 3-10 所 示 。 


Xampp 管 理 界面 可 以 支持 多 种 语言 ， 


若 要 使 


Xampp 主 要 组 件 的 运行 状态 。 


he 和 MySQL 的 控制 按钮 ， 我 们 让 


中 文 可 以 从 页 面 右上 方 的 语言 选项 中 选择 。 另 外 ， 界 面 的 左边 是 Xampp 所 有 的 功能 选项 ， 接 下 来 ， 介 绍 


contrib 


Mercuryllail 


security 


webalizer 


catalina_stop. bat 


MS-DOS 拭 处 理 文 件 
1 KB 


mar mercury_stop. bat 


MS-DOS PANPI 


xampp stop. exe 
Start and ste °p X 


Apache Friends 


FileZillaFTP 


sendmail 


webdav 


Ed SESS. bat 
Dos 批 处 理 文件 
KB 


"| mysql start.bat 
MS-DOS 批 处 理 文件 
1 KB 


service, exe 


puse cce 


， 找 到 “xampp-control.exe” 文 件 ， 双 击 打 开 ， 会 看 到 如 图 3-9 所 示 的 Xampp 控 制 台 界 面 。 


EXA "Start" 按钮 就 可 启动 Apache 和 MySQL 了 ， 非 常 方便 。 接 着 我 们 打开 浏览 器 ， 输 


其 中 比较 重要 的 几 个 管理 工具 。 


DJ ZANEPP Control Panel Application 


[z] UE CUN EB. Sergice.... 


F Mod ules- 


MySql | Admin... | 
FileZilla Star Admin... 
Mercury 


AAMPP Control Panel Version 2.5 (9. May, 2007) 
Windows 5.1 Build 2600 Platform 2 Service Pack 3 
Current Directory: D:\xampp 

Installer) Directory: d:\xampp 

Status Check OK 

Busy... 

Apache stopped [Port 80] 


< 


图 3-9 Xamppd£ 4] & 


€ )> |i. localhost/xampp/indexphp 
— 


Orr - e |[38- oc 月 |@|. | || e- 


[z) XAM P P for Wi n dows English ; Deutsch / Francalsy Tlederisnds / Polskly Italiano ! Norwegian 


Español; AN / Portugués (Brasil) / BAB 


欢迎 使 用 XAMPP for Windows! 


tes: 
SEER f XAMPPI 


现在 容 可 以 行 治 生 用 Apasche 以 及 芝 他 的 组 件 , 首先 , 您 可 以 通过 并 如 的 9 叶 航 全 上 的 状 志 ees S4p41E Z= Les. 
您 可 以 通过 浏览 https ://127.0.0.1 或 者 httns://ocalhost 来 验 江 Open55L 
t=, Kay Vogelgessng + Kai 'Oswald' Seidler 


= T 
CD 

生 侠 月 期 
Instant Art 
Biase 


Perl 
perlinfo() 
Guest Book 


J2EE 
状态 
Tomcat examples 


工具 
phpMyAdmin 
Webalizer 
Mercury Mail 
Filezilla FTP 


3-10 ”Xampp 管 理 界面 


安全 : 如 果 你 想 用 Xampp 作 为 正式 环境 ， 这 个 部 分 就 很 重要 ， 因 为 这 里 涉及 一 些 关于 Xampp 安 全 的 注意 事项 。 


: 文档 : Xampp 常 用 组 件 的 文档 ， 包 括 Apache、MySQL 等 。 


: phpinfo () : 此 选项 查看 的 是 PHP 的 系统 参数 ， 比 如 ， 如 果 我 们 需要 查找 一 些 PHP 的 模块 是 否 已 经 安装 就 可 以 在 这 里 查看 。 


: phpMyAdmin: MySQL 数 据 库 管 理工 具 ， 关 于 此 工具 将 在 3.2. 


4 节 中 做 详细 介绍 。 


: Webalizer: 简单 小 巧 的 Web 日 志 分 析 工具 ， 可 做 简单 的 访问 分 析 。 


: Mercury Mail: Mail 服 务 器 ， 建 议 仅 供 调试 。 


: FileZilla FTP: FTP 服 务 器 ， 建 议 仅 供 调试 。 


Xampp 的 管理 工具 看 起 来 非常 多 ， 然 而 ， 在 开发 过 程 中 经 常用 到 的 管理 工具 并 不 多 ， 最 经 常用 到 的 无 非 就 是 使 用 “phpinfo () ”查看 PHP 环 境 参数 ， 以 及 使 用 “phpMyAdmin” 管 理 MySQl 数 据 库 


等 。 


3.2.3 ”管理 Apache 


Apache 服 务 器 是 当今 功能 最 为 强大 的 HTTP 服 务 器 之 一 ， 也 是 目 


前 全 球 市 场 占有 率 最 高 的 HTTP 服 务 器 。 因 此 ， 对 于 服务 端 开发 者 来 说 ， 如 何 管理 Apache 应 该 算是 一 个 必须 学 习 的 内 容 ， 当 然 ， 如 果 你 


想 仅仅 通过 本 节 就 完全 掌握 Apache 这 是 绝对 不 可 能 的 ， 因 为 仅仅 是 Apache 的 日 常 管理 文档 就 可 以 写成 一 本 很 厚 的 参考 书 。 本 节 我 们 主要 介绍 一 下 在 PHP 服 务 端 开 发 过 程 中 ，Apache 服 务 器 的 基本 用 法 。 


由 于 Xampp 环 境 已 经 帮助 我 们 把 Apache 和 PHP 结 合 起 来 了 ， 所 以 不 需要 做 任何 配置 就 可 以 让 Apache 支 持 PHP 脚 本 。 以 下 是 一 些 在 日 常 开 发 过 程 中 常 出 现 的 操作 ， 让 我 们 来 分 别 学 习 一 下 。 


1. 启 动 和 停止 


在 Xampp 中 启动 和 停止 Apache 非 常 简单 ， 可 直接 在 Xampp 控 抽 


2. 设 置 虚拟 主机 (Virtual Host) 


当 我 们 开发 一 个 新 的 网 络 应 用 时 ， 首 先 ， 我 们 需要 给 这 个 网 络 应 
过 以 下 步骤 来 设置 Apache 的 虚拟 主机 。 


配置 清单 3-1 


台中 进行 操控 。 如 果 有 疑问 可 以 参考 3.2.2 节 的 内 容 。 


用 分 配 一 个 域名 ， 那 么 我 们 怎么 在 开发 机 上 访问 这 个 域名 呢 ， 我 们 假设 现在 要 做 的 网 络 应 用 的 域名 是 “http://test-app”， 我们 可 以 通 


首先 ， 我 们 需要 找到 并 打开 Windows 本 地 的 host 文 件 ， 该 文件 位 置 如 下 : C: \WINDOWS\system32\drivers\etc\hosts， 并 在 文件 尾部 加 上 如 配置 清单 3-1 所 示 的 内 容 。 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


127.0.0.1 test-app 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


然后 ， 我 们 再 打开 Apache 的 虚拟 主机 配置 文件 ， 该 文件 位 于 Xampp 中 的 Apache 目 录 下 ， 如 D: \xampp\apache\conf\extra\httpd-vhosts.conf， 其 中 我 们 加 入 如 配置 清单 3-2 所 示 的 配置 信息 。 


配置 清单 3-2 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


NameVirtualHost *:80 
<VirtualHost *:80> 
DocumentRoot "/path/to/test-app" 
ServerName test-app 
<Directory /> 
AllowOverride All 
Allow from all 
</Directory> 
</VirtualHost> 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


接着 ， 我 们 在 站 点 根 目录 (DocumentRoot) 中 放 入 一 个 测试 PHP 脚 本 ， 


代码 清单 3-13 


于 测试 环境 是 否 配置 成 功 ， 如 代码 清单 3-13 所 示 。 


<?php 
phpinfo(); 
?» 


最 后 ， 重 启 Apache 服 务 器 ， 打 开 浏览 器 并 输入 刚才 准备 好 的 PHP 脚 本 文件 进行 测试 ， 效 果 如 图 3-11 所 示 。 


php-demoj/basic/info.php 


\sdk, shared" “wh odii Dio «di orsdeimantdintiOwdk hend: *--with- 
oci8-11g=D:\php- pasar a aod qoam *--enable-object- 


如 果 看 到 的 页 面 和 上 图 的 一 样 ， 那 么 表示 我 们 的 PHP 网 络 脚本 开发 运行 环境 准备 就 绪 了 。 学 会 这 些 之 后 ， 


324 管理 MySQL 


图 3-11 info.php 运 行 结 


£ 


你 还 可 以 在 该 应 用 目录 下 编写 其 他 的 PHP 脚 本 进行 学 习 。 


MySQIl 数据库 绝对 是 现在 市 面 上 最 为 流行 的 开源 数据 库 之 一 。 实 际 上 ，PHP 和 MySQL 在 很 早 以 前 就 被 认为 是 互联 网 领域 的 “天 作 之 合 ”，PHP 为 MySQL 提 供 了 非常 稳定 而 高 效率 的 数据 库 接口 ， 而 
MySQL 又 为 PHP 提 供 了 灵活 而 强大 的 数据 存储 方式 ， 所 以 在 学 习 PHP 的 同时 ，MySQL 也 就 自然 而 然 变 成 必 学 内 容 中 的 一 部 分 了 。 


和 Apache 一 样 ，MySQL 同 样 是 一 个 庞然大物 ， 想 
来 管理 MySQL 数 据 库 。 


1. 稳 定性 


一 节 的 文字 就 把 MySQL 完 全 说 清楚 同样 是 不 大 现实 的 导 


首先 ， 我 们 来 简单 介绍 一 下 MySQL 数 据 库 。 和 本 书 中 所 介绍 的 其 他 组 件 一 样 ，MySQL 是 开源 而 且 免 费 的 ， 


和 有情 ， 因 此 在 本 节 中 我 们 只 对 MySQL 本 身 做 简单 介绍 ， 主 要 介绍 如 何 使 用 phpMyAdmin 工 具 


除 此 之 外 ， 它 还 有 以 下 几 个 主要 的 优势 和 特点 。 


对 于 数据 库 来 说 ， 稳 定性 毫 无 疑问 是 最 重要 的 。 对 于 MySQL 的 稳定 性 ， 其 实 无 须 多 虑 ， 作 为 目前 全 球 最 受 欢 迎 的 开源 数据 库 ，MySQL 被 无 数 的 互联 网 应 用 所 采用 ， 比 如 Facebook 等 。 而 在 这 些 成 功 的 


实例 中 ，MySQL 扮 演 着 最 稳定 的 数据 存储 后 盾 的 角色 。 


2. 高 性 能 


支持 多 线程 ， 性 能 佳 ， 同 时 (在 配置 文件 my.cnf 中 ) MySQL 还 提供 了 非常 丰富 的 性 能 配置 选项 。 我 曾经 对 目前 Linux 上 的 多 个 主流 数据 库 做 过 高 并 发 的 压力 测试 ，MySQL 的 处 理 能 力 绝对 是 名 列 前 茅 


的 。 


3. 灵 活性 


单 台 MySQL 服 务 器 支持 的 对 象 数 达 到 十 亿 (Billion) 级 别 ， 因 此 从 理论 上 来 讲 ， 在 性 能 没有 下 降 的 前 提 下 ， 
MySQL 服 务 器 上 模拟 分 库 分 表 ， 当 然 ， 我 们 甚至 还 可 以 在 一 台 服 务 器 上 建立 多 个 MySQL 实 例 。 


4 支持 主 从 


我 们 可 以 建立 任意 多 个 数据 库 ， 每 个 数据 库 中 包含 任意 多 张 数据 表 ， 这 样 我 们 就 可 以 在 一 台 


主 从 复制 (Replication) 也 是 MySQL 最 重要 的 特性 之 一 ，MySQL 支 持 一 主 多 从 ， 以 及 互 为 主 从 两 种 模式 。 我 们 常用 的 是 一 主 多 从 的 方式 ， 在 主 从 模式 运行 时 ， 主 库 会 持续 地 把 数据 同步 到 从 库 上 去 ， 


一 般 来 说 我 们 会 将 主 库 作 为 写 库 而 从 库 作 为 读 库 ， 这 样 做 的 好 处 是 : 多 个 从 库 不 仅 可 以 为 主 库 分 担 读 的 压力 ， 而 且 还 可 以 为 主 库 提供 多 套数 据 备份 ， 当 主 库 出 问题 时 ， 我 们 可 以 通过 修改 配置 快速 地 进行 数 


据 恢复 。 


5 .支持 集群 


在 MySQL 5 之 后 也 支持 使 用 NDB Cluster 存 储 引 擎 来 实现 多 Cluster 的 服务 器 集群 ， 但 是 在 PHP 项 


6 插件 丰富 


据 我 了 解 MySQL 的 插件 应 该 是 目前 所 有 数据 库 中 最 多 的 ， 针 对 各 种 不 同 的 使 


等 。 丰 富 的 插件 系统 也 使 得 MySQL 的 应 


接 下 来 ， 我 们 来 看 看 在 Xampp 环 境 下 如 何方 便 地 管理 MySQL。 在 3.2.2 节 中 曾经 提 到 过 Xampp 自 带 的 phpMyAdmin 管 理工 具 ， 此 工 


打开 操作 ， 界 面 如 图 3-12 所 示 。 


范围 越 来 越 广 。 


中 通常 依靠 程序 逻辑 来 实现 数据 库 集群 的 功能 。 


场景 ， 都 会 有 不 同 的 数据 库 引 警 或 者 数据 库 插件 与 之 对 应 ， 比 如 近 几 年 出 现 的 MySQL 的 NoSQL 处 理 引 擎 HandleSocket 


是 由 纯 PHP 写 出 来 的 ， 特 点 就 是 部 署 完 之 后 可 以 直接 在 浏览 器 中 


图 3-12 展 示 的 就 是 phpMyAdmin 的 主 界面 (在 不 同 的 版 本 里 phpMyAdmin 的 界面 表现 可 能 会 稍 有 不 同 ， 但 是 功能 布局 肯定 是 不 会 变 的 ) ， 左 边 灰 色 的 列表 就 是 目前 所 有 的 MySQL 数 据 库 列表 ， 其 中 除 
了 mysql、information_schema、performance_schema 以 及 test 是 MySQL 自 带 的 数据 库 之 外 ， 其 他 的 数据 库 都 是 后 来 添加 的 。 我 们 单 击 对 应 的 数据 库 名 就 可 以 进入 对 应 的 数据 库 管理 界面 ， 例 如 我 们 和 
击 cdco 路 据 库 ， 会 看 到 如 图 3-13 所 示 的 管理 界面 。 


Tite 


从 图 3-13 中 可 以 看 到 ，cdcol 库 中 只 有 一 个 表 cds， 单 击 表 名 就 可 以 在 右边 看 到 表 里 所 有 数据 的 列表 ， 当 然 我 们 可 以 对 这 些 数据 进行 增删 查 改 等 动作 。 另 外 ， 在 数据 列表 上 面 我 们 可 以 看 到 所 有 操作 的 相 
关 SQL， 非 常 方便 ; SQL 栏 上 方 还 有 一 排 按钮 选项 ， 这 些 选 项 的 功能 也 是 日 常 操作 中 经 常 使 用 的 ， 下 面 简单 介绍 一 下 。 


h localhost/phomyadmin 


—— 
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3-13 phpMyAdmin 数据 表 管 理 


: 浏览 : 上 默认 的 功能 ， 用 于 管理 表 中 的 数据 。 


: 结构: 用 于 查看 表 的 详细 结构 ， 还 可 以 添加 索引 。 


| SQL: 使 用 我 们 自己 编写 的 SQL 语句 进行 数据 表 操 作 。 


“ 搜索 : 快捷 地 使 用 模糊 搜索 查找 数据 。 


HBA: 插入 新 的 数据 。 


“ 导出 : 导出 表 中 的 数据 ， 一 般 用 于 数据 备份 或 者 转移 ; phpMYAdmin 提 供 了 非常 多 的 导出 方式 和 选项 ， 一 般 来 说 MySQL 导 出 的 文件 都 是 文本 SQL 文件 。 


“导入: 和 导出 相反 的 功能 ， 一 般 用 于 数据 恢复 。 


“ 操作 : 提供 一 些 其 他 的 高 级 功能 选项 ， 比 如 修改 数据 表 名 、 修 改 存储 引擎 、 修 改 字符 集 等 操作 ， 需 要 了 解 更 多 信息 请 进入 相应 界面 查看 。 


清空 : 清空 表 内 所 有 数据 ， 此 操作 在 未 开启 事务 的 情况 下 不 可 恢复 ， 请 慎 用 ! 


: 删除 : 删除 整 张 表 ， 请 慎 用 ! 


由 于 篇 幅 限制 ， 对 于 phpMyAdmin 的 一 些 主要 功能 的 介绍 到 此 为 止 ， 如 果 你 想 熟 悉 这 个 工具 建议 动手 操作 一 下 ， 熟 悉 一 下 这 个 MySQL 管 理工 具 的 日 常 功 


33 ”使 用 JSON 通 信 


26 
Be, 


这 对 后 面 的 服务 端 开发 是 非常 


SSA. 


实际 上 ， 第 1 章 中 介绍 如 何 结合 Android 和 PHP 学 习 时 ， 我 们 就 曾经 提 到 过 JSON 协 议 ， 本 节 我 们 就 来 学 习 一 下 这 个 协议 的 基本 内 容 。JSON 是 Javascript 对 象 表示 法 (JavaScript Object Notation) 的 


简称 ，JSON 协 议 源 自 JavaScript 脚 本 语言 
应 用 的 数据 封装 。 


的 对 象 持久 化 表示 方法 ， 由 于 这 种 表示 法 比较 简单 易 性 


Š, 而 且 传 输 的 数据 也 比较 小 巧 ( 相 对 于 XML 来 说 应 该 算是 非常 小 巧 了 ) , Bb, 38 


F 来 被 广泛 地 


首先 ， 我 们 来 学 习 一 下 JSON 协 议 的 数据 表示 方法 。 在 JSON 协 议 中 ， 最 基本 的 数据 结构 只 有 两 种 。 第 一 种 是 数组 结构 ， 该 结构 类 似 于 PHP 中 的 列表 数组 ， 结 构 如 下 。 


于 互联 网 


["james","iris"] 


第 二 种 是 对 象 结构 ， 该 结构 非常 类 似 于 PHP 中 的 散 列 数组 ， 结 构 如 下 。 


("id":1, "name" :"james"} 


当然 ， 将 以 上 两 种 结构 结合 起 来 就 可 以 产生 其 他 形式 的 数据 结构 ， 比 如 对 象 数组 ， 也 就 是 类 似 于 PHP 中 的 “ 散 列 数组 列表 ”的 形式 ， 结 构 如 下 。 


{"id":1,"name":"james"}, 
id":2,"name":"iris") 


另外 ，JSON 协 议 几 乎 支持 所 有 主流 语言 的 客户 端 ， 当 然 也 包括 PHP 语 言 


。 在 PHP 中 使 用 JSON 非 常 方便 ， 在 PHP 5.2 版 本 之 后 ，PHP 语 言 已 经 内 置 了 JSON 的 加 解码 函数 ， 即 json_encode 和 


json_decode。 接 下 来 ， 让 我 们 来 分 析 一 下 代码 清单 3-14 中 的 逻辑 代码 。 


代码 清单 3-14 


<?php 
// 原始 数据 
Sarr = array( 
array ( 
"id" = 1, 
"name" => "James" 
), 
array ( 
"id" => 2, 
"name" => "Iris" 


) 
); 
// 数组 转换 为 JSON 格 式 


$str = json encode (Sarr) ; 

echo "Array => JSON : ".$str."WMn"; 
// JSON 转 换 为 数组 格式 

echo "JSON => Array : "; 

$arr = json decode ($str) ; 

print r($arr); 

?> 


以 上 代码 演示 了 如 何 使 用 PHP 内 置 的 加 解码 函数 来 进行 JSON 数 据 和 PHP 数 组 结构 之 间 的 相互 转换 ， 运 行 结果 如 图 3-14 所 示 。 


C:\FINDOFS\system32\cad. exe 


D: workspace \php\basic>php demo8.php 
Array => JSON : [< id :1 , name": "James">.<"id":2. "name": "Iris" ] 
JSON => Array : Array 
< 
[8] => stdClass Object 
€ 
[idl => 1 
[name] => James 


[1] => stdClass Object 
€ 
[id] => 2 
[name] => Iris 


D: \works pace \phpNbas ic > 


图 3-14 ”代码 清单 3-14 的 运行 结果 


这 里 随便 提 一 下 ， 在 Android 中 我 们 使 用 orgjson 包 来 进行 JSON 加 解码 工作 ，JSON 数 组 格式 可 使 用 SONArray 类 处 理 ， 而 对 象 结构 则 使 用 SONObject 类 处 理 。 关 于 Android 使 用 JSON 的 具体 使 用 方 
法 和 实例 我 们 将 在 7.3.3 节 中 做 详细 介绍 。 


随 着 互联 网 应 用 的 发 展 ， 我 们 过 去 依靠 原生 PHP 代 码 进行 编程 的 路 已 经 走 不 通 了 。 因 为 ， 随 着 代码 逻辑 越 来 越 复 杂 ， 如 果 没 有 一 个 好 的 框架 来 管理 和 组 织 代码 ， 乱 七 八 糟 的 巨 量 代码 最 终 必 将 把 整个 项 
目 毁 掉 ， 这 也 是 我 们 在 项 目 结束 之 后 还 要 花 那么 大 的 资源 和 精力 对 代码 进行 不 断 优化 和 重 构 的 原因 。 当 然 ， 如 果 我 们 在 项 目 开 始 时 就 采用 一 个 比较 好 的 框架 进行 开发 ， 不 仅 可 以 让 以 后 的 功能 扩充 变 得 更 加 
简单 ， 还 可 以 为 日 后 的 代码 维护 减少 工作 量 。 目 前 市 面 上 流行 的 PHP 框 架 非常 多 ， 接 下 来 我 们 会 对 其 中 比较 有 代表 性 的 几 个 框架 做 一 些 介绍 和 对 比 。 


Zend Framework 简 称 ZF， 是 PHP 的 官方 框架 ， 优 点 是 功能 强大 、 结 构 松 散 、 封 装 完善 ， 很 适合 作为 二 次 开发 的 基础 框架 ， 它 包含 了 几乎 所 有 你 能 想到 的 关于 互联 网 方面 的 功能 类 库 。 当 然 ，ZF 的 类 库 
包 也 很 大 ， 框 架 类 库 就 将 近 20MB， 当 然 其 中 大 部 分 我 们 是 用 不 到 的 。 虽 然 ZF 看 起 来 比较 “笨重 ”， 但 是 它 所 提供 给 开发 者 的 自由 度 是 其 他 框架 所 不 能 比较 的 ， 针 对 那些 需求 比较 灵活 或 者 结构 比较 复杂 的 
大 型 项 目 而 言 ，ZF 确 实 不 失 为 一 个 很 好 的 选择 。 


笔者 建议 大 家 去 深入 学 习 ZF 框 架 ， 最 好 是 能 把 ZF 的 主要 逻辑 和 类 库 的 代码 读 一 遍 ， 因 为 从 中 你 不 仅 可 以 学 到 很 多 PHP 语 言 的 编程 技巧 ， 还 可 以 学 到 很 多 有 用 的 “设计 模式 ”以 及 “封装 ”的 技巧 ， 这 些 
知识 和 经 验 都 会 对 大 家 今后 的 编程 之 路 大 有 神 益 。 


此 外 ， 本 书 实战 篇 中 的 项 目 实例 将 会 使 用 一 个 基于 ZF 的 框架 Hush Framework 来 进行 开发 ， 因 此 学 习 ZF 对 大 家 来 说 也 是 非常 必要 的 。 当 然 ， 由 于 本 书 的 篇 幅 限 制 ， 我 们 不 可 能 在 这 里 把 ZF 全 部 给 大 家 
讲 一 遍 ， 但 是 我 们 在 3.6 节 中 在 对 Hush Framework 进 行 讲 解 时 会 涉及 ZF 框架 的 一 些 内 容 ， 建 议 大 家 认真 阅读 和 体会 ， 相 信 其 中 的 知识 会 对 深入 学 习 ZF 框 架 有 很 大 帮助 。 


c 本 书 的 “封装 ” 指 的 是 一 种 基于 面向 对 象 思想 的 组 织 代码 的 方法 ， 后 面 会 多 次 提 到 这 个 概念 ， 大 家 在 阅读 时 可 以 注意 一 下 。 


Codelgniter (Cl) 也 是 一 个 比较 老牌 的 PHP 框 架 ， 和 ZF 相反 ， 它 非常 小 巧 ， 核 心 类 库 仅 有 1MB 左 右 ， 使 用 起 来 比较 简单 ， 代 码 框架 遵循 常见 的 MVC 结 构 ;， 但 是 CI 的 类 库 封装 得 还 不 够 精细 ， 某 些 框 架 
屋 次 感觉 设计 得 过 于 繁琐 ， 另外， 我 认为 CI 的 文档 做 得 不 是 很 好 ， 特 别 是 中 文 的 文档 ， 当 然 这 可 能 是 多 种 原因 造成 的 ， 但 是 不 可 否认 的 是 ， 这 个 问题 大 大 阻碍 了 CI 框架 在 国内 的 普及 。 


3.CakePHP (http://cakephp.org/) 


CakePHP 是 一 个 典型 的 仿 RoR 类 型 的 框架 ， 它 的 脚手架 (scaffold) 功能 还 不 错 ， 也 非常 的 小 七， 类 库 相 对 来 说 设计 得 主流 化 一 点 ， 但 是 模板 支持 部 分 还 做 得 不 够 好 ， 另 外 系统 设计 的 耦合 度 比较 高 ， 
如 果 遇 到 一 些 大 型 项 目 会 有 点 棘手 ， 比 如 需要 分 库 分 表 ， 以 CakePHP 目 前 的 做 法 会 比较 麻烦 。 


4.ThinkPHP (http://www.thinkphp.cn/) 


ThinkPHP 是 必须 要 介绍 的 ， 是 近 几 年 出 现 的 比较 优秀 的 产品 之 一 。 整 体 来 说 ，ThinkPHP 很 快 ， 几 乎 是 所 有 PHP 框 架 中 最 快 的 ， 也 很 小 巧 ， 所 有 的 类 包 加 起 来 才 几 百 KB; 在 设计 方面 相对 比较 松散 ， 易 
于 学 习 ; 另外 ， 文 档 也 相当 完善 ， 确 实 是 近年 来 出 现 的 一 个 不 错 的 PHP 框 架 ， 但 是 面 对 大 型 项 目 同样 有 一 些 不 方便 的 地 方 。 


当然 ， 面 对 如 此 多 的 PHP 框 架 ， 到 底 应 该 学 习 哪 一 个 呢 ? — 如 果 你 只 想 快 速 地 开发 出 一 个 应 用 ， 那 么 可 以 选择 Think、Cake 或 者 Cl 等 敏捷 型 的 开发 框架 ; 但是， 如 果 你 想 要 更 深入 地 
学 习 PHP 语 言 ， 甚 至 PHP 中 的 各 种 设计 模式 ， 请 选择 ZF。 当 然 ， 在 后 面 的 章节 中 ， 我 们 将 会 向 大 家 介绍 一 个 基于 ZF 和 Smarty 的 PHP 开 发 框架 ， 也 就 是 Hush Framework。 


3.5 “认识 Smarty 模 板 引 警 


如 果 你 说 学 过 PHP 而 没 学 过 Smarty 模 板 引擎， 我 相信 所 有 的 面试 官 都 会 觉得 你 在 撒谎 。 虽 然 PHP 语 言 本 身 就 可 以 嵌入 到 HTML 页 面 中 去 进行 数据 展现 ， 但 是 这 样 做 我 们 不 仅 需要 书写 大 量 的 <? php? > 
标签 ， 而 且 在 某 些 地 方 还 需要 嵌入 大 量 的 元 余 代码 ， 另 外 也 不 利于 逻辑 的 解 耦 和 分 离 。 所 以 ， 在 项 目 中 我 们 还 是 需要 一 个 专门 的 模板 引擎 ， 而 Smarty 就 是 PHP 语 言 在 这 个 领域 的 不 二 选择 了 。 


目前 ,最 新 的 Smarty 版 本 已 经 出 到 3.x， 相 对 于 2.x 版 本 有 了 很 大 的 改进 ， 接 下 来 简单 介绍 一 下 Smarty 的 使 用 。 实 际 上 ，Smarty 的 下 载 包 中 本 来 就 包含 了 一 些 实例 代码 。 首 先 ， 从 官方 下 载 地 址 
(http://www.smarty.net/download) 下 载 最 新 的 稳定 的 开发 包 版 本 (Latest Stable Release) ， 我 们 在 这 里 使 用 的 是 Smarty 3.1.5 版 本 ， 该 版 本 必须 运行 于 PHP 5.2 以 上 的 版 本 中 。 


解压 之 后 ， 我 们 把 smarty-3.1.5 重 新 命名 为 smarty 并 放 入 我 们 前 面 配置 好 的 站 点 目录 ， 然 后 在 浏览 器 中 打开 demo 地 址 (http://php-demo/smarty/demo/) ， 打 开 的 界面 如 图 3-15 所 示 。 


php-demojsmarb demo/ Be = | [8g - Goo 


Title: Welcome To Smarty! 


The current date and time is 2011-11-17 07:06:52 

The value of global assigned variable SSCRIPT NAME is /smarty/demo/index.php 
Example of accessing server environment variable SERVER NAME: php-demo 
The value of ($Namej is Fred Irving Johnathan Bradley Peppergill 

variable modifier example of ($Namelupperj 


FRED IRVING JOHNATHAN BRADLEY PEPPERGILL 


An example of a section loop: 


1 * John Doe 

2 * Mary Smith 

3 . James Johnson 
4 . Henry Case 


An example of section looped key values: 


图 3-15 Smarty demo 的 运行 效果 


小 贴 士 : 如 果 你 找 不 到 站 点 目录 ， 请 返回 查看 3.2.3 节 中 Apache 配 置 虚拟 主机 的 部 分 内 容 。 


以 上 这 个 界面 就 是 由 Smarty 模 板 引擎 泻 染 出 来 的 页 面 ， 其 对 应 的 PHP 文 件 的 代码 ， 见 代码 清单 3-15， 已 添加 注释 ， 方 便 读者 阅读 。 


代码 清单 3-15 


<?php 

// 包含 Smarty XE 

require ('http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/.../libs/Smarty.class.php'); 
// 初始 化 Smarty 对 象 

$smarty = new Smarty; 

// 初始 化 Smarty 配置 

//Ssmarty->force_compile = true; 

$smarty-»debugging = true; 

$smarty-»caching = true; 

$smarty-»cache lifetime = 120; 

// 各 种 变量 赋值 

$smarty->assign ("Name", "Fred Irving Johnathan Bradley Peppergill", true) ; 

$smarty-»assign ("FirstName", array ("John", "Mary"; "James", "Benry") ); 

$smarty-»assign ("LastName", array ("Doe", "Smith", "Johnson", "Case")) ; 

$smarty-»assign ("Class" „array (array (" "A" "BN, nOn "D") aypay ("E" "E" "Gh TMn), 

array ("I", "J", "K","L") ,array ("M", "N"," MPM): 

Ssmarty-»assign (" contacts", array (array (" 1", "fax" = t "cell" 
=> "3"),array("phone" => "555-4444", "fax" => 555- 3335" "cell => 47602 1234"))); 
$smarty-»assign ("option values", array (" "NY", "NE", "KS", "IAM EOR MERI) 
$smarty-»assign("option output", array ("New York", "Nebraska", "Kansas", "Iowa", 
"Oklahoma", "Texas") ) 7 


$smarty->assign ("option selected", "NE"); 
// 泻 染 相 应 模板 
$smarty-»display('index.tpl'); 

2> 


从 上 面 的 代码 我 们 可 以 很 清晰 地 看 到 Smarty 的 一 般 使 用 过 程 : 先 初始 化 smarty 对 象 ， 然 后 配置 smarty 参 数 ， 接 着 就 是 进行 各 种 变量 的 赋值 ， 最 后 在 模板 页 面 展现 出 来 。 对 于 本 例 ， 大 家 可 以 看 看 
index.tplI 中 的 模板 写法 ， 当 然 Smarty 的 用 法 还 是 很 丰富 的 ， 想 学 好 它 ， 最 好 的 老师 就 是 官方 文档 了 ， 请 参考 “http://www.smarty.net/docs/en/”。 以 下 我 们 也 简单 介绍 几 种 在 开发 时 需要 掌握 的 核心 要 


1. 常 用 配置 选项 


在 使 用 Smarty 模 板 引擎 之 前 ， 我 们 必须 先 学 习 如 何 配置 Smarty 的 选项 。 而 在 Smarty 的 常见 选项 中 ,我 们 首先 必须 了 解 4 个 最 基本 的 目录 选项 。 


: 模板 目录 (template) : 本 目录 用 于 存储 模板 文件 ， 需 要 泻 染 对 应 文件 时 把 文件 相对 地 址 作为 参数 传 入 display 方 法 即 可 。 比 如 ， 我 们 有 一 个 模板 文件 地 址 位 于 template/test/index.tpl， 那 么 我 们 则 应 当 
使 用 “$smarty->display (‘test/index.tpl') ; ”语句 来 泻 染 该 模板 。 


- 编译 模板 目录 (template c) : 本 目录 主要 用 于 存储 Smatty 模 板 引 擎 产生 的 模板 编译 文件 ，Smarty 也 正 是 使 用 这 种 方法 来 提高 执行 效率 的 。 当 然 ， 我 们 在 部 署 项 目 时 一 定 要 注意 该 目录 必须 是 可 写 的 。 
- 缓存 目录 (cache) : Smarty 允 许 把 展示 过 的 模板 缓存 起 来 ， 使 用 此 功能 将 进一步 提高 模板 引擎 的 运行 速度 。 当 然 ， 我 们 还 可 以 通过 设置 cache_lifetime 属 性 来 控制 缓存 文件 的 有 效 时 间 。 


: 配置 目录 (configs) : 这 个 目录 可 以 用 于 保存 Smarty 模 板 引 擎 的 配置 文件 ， 不 过 在 实际 项 目 中 使 用 得 比较 少 ， 我 们 经 常会 把 配置 放 入 项 目 统一 的 配置 目录 。 


在 实际 项 目 中 我 们 经 常 使 用 继承 和 重 载 的 方式 来 定制 和 配置 我 们 自己 的 smarty 模 板 类 。 比 如 ， 在 代码 清单 3-16 中 ， 我 们 就 实现 了 一 个 自 定义 的 My_ Smarty 类 ， 此 类 中 设置 了 Smarty 模 板 的 必要 目录 和 
缓存 的 生效 时 间 。 


代码 清单 3-16 


<?php 

// 包含 Smarty 类 库 

require 'Smarty.class.php'; 

// 定义 自己 的 模板 类 

class My Smarty extends Smarty 
{ 


function _ construct () 


{ 
// 重 载 Smarty XX 
parent:: construct (); 
// REAR 
$this-»setTemplateDir(' /path/to/templates/'); 
Sthis-»setCompileDir('/path/to/templates c/'); 
Sthis-»setConfigDir('/path/to/configs/'); 
$this->setCacheDir ('/path/to/cache/') ; 
// 配置 缓存 
Sthis->caching = true; 
Sthis->cache lifetime = 60; 
// 设置 默认 变量 
$this->assign('app_name', 'My App'); 


在 上 述 代码 中 ，setTemplateDir 方 法 用 于 设置 模板 目录 ，setCompileDir 方 法 用 于 设置 编译 过 的 中 间 模 板 目录 ，setConfigDir 和 setCacheDir 方 法 分 别 用 于 设置 Smarty 模 板 的 配置 文件 和 缓存 文件 的 
录 。 


2. 常 用 模板 语法 


Smarty 3.0 中 的 语法 实际 上 和 PHP 的 语法 已 经 比较 接近 了 ， 使 用 起 来 相当 方便 。 接 下 来 让 我 们 来 熟悉 一 下 Smarty 模 板 语言 的 基本 用 法 。 首 先 ， 我 们 要 知道 所 有 的 Smarty 的 默认 界限 符号 是 大 括号 (当然 
这 个 也 是 可 以 设置 的 ) 。 因 此 ， 我 们 可 以 通过 类 似 于 “{$var}” 的 写法 来 获取 Smarty 变 量 “var” 的 值 。 其 次 ，Smarty 中 为 我 们 提供 了 大 量 的 字符 串 辅助 标签 ， 非 常 方便 例如， 如果 需要 把 某 个 变量 的 首 
字母 大 写 ， 使 用 方法 如 代码 清单 3-17 所 示 。 


代码 清单 3-17 


{SarticleTitle|capitalize} 


另外 ， 如 果 我 们 想 把 时 间 戳 转化 为 需要 的 时 间 格 式 ， 使 用 方法 如 代码 清单 3-18 所 示 。 


代码 清单 3-18 


($smarty.now|date format] 
($smarty.now|date format:"$Y-$m-$d"] 


此 外 ， 我 们 还 可 以 使 用 代码 清单 3-19 中 的 类 似 方法 来 过 滤 非 法 字符 ， 避 免 XSS ( 跨 站 攻击 ) 的 风险 。 


代码 清单 3-19 


{SarticleTitle|escape: 'html'] 
{SarticleTitle|escape: 'htmlall'] 


接 下 来 ， 我 们 还 会 介绍 一 下 在 展示 过 程 中 最 常用 到 的 循环 语句 的 写法 。 实 际 上 在 Smarty 中 有 两 种 最 常用 到 的 循环 语句 写法 ， 一 种 是 “{section}” ， 另 一 种 是 “{foreach}”。 现 在 假设 我 们 需要 循环 一 个 
散 列 数组 列表 “$userList” ， 散 列 数组 中 包含 “id” 和 “name” 两 个 字段 ， 示 例 见 代 码 清单 3-20， 大 家 可 以 好 好 理解 一 下 。 


代码 清单 ”3-20 


{* 注释 : 使 用 section 标 签 循环 *) 
{section name=user loop=SuserList} 


ID : {SuserList [user] .id} 
NAME : {SuserList [user] .name} 
{/section} 


{* 注释 : 使 用 foreach 标 签 循环 *} 
{foreach $userList as $user} 
ID : {$user.id} 

NAME : {Suser.name} 

{/foreach} 


从 上 面 的 代码 中 可 以 看 出 ，Smarty 3.089foreach FRAGA AIPHPAYIBIAIEBSMUT , BES EBE 2 75 (ESCAR, HEAR EA. 535b, ESmartyh tRNR 
 "{*http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...*}" E, 这 个 也 需要 大 家 了 解 一 下 。 


由 于 篇 幅 限制 ，Smarty 模 板 引擎 的 基本 使 用 我 们 介绍 到 这 里 ， 关 于 其 更 多 的 信息 请 大 家 参考 官方 的 文档 并 动手 实践 一 下 ， 毕 竟 Smarty 模 板 也 是 使 用 PHP 进 行 服务 端 开发 的 必 不 可 少 的 一 项 技能 。 


3.6 ”开发 框架 简介 


Hush Framework。 本 书后 面 微 博 实例 的 服务 端 程序 也 将 采用 该 框架 进行 开发 。 


在 实际 项 目 中 ， 我 们 通常 要 先 选 择 一 个 比较 适合 项 目 特点 的 框架 ， 然 
比较 主流 的 PHP 框 架 ， 并 选 定 了 Zend Framework 为 本 书 实例 
架 ， 个 人 还 是 非常 推荐 大 家 使 


3.6.1 ”框架 的 特点 和 优势 
从 某 种 程度 上 来 说 Hush Framework 框 架 的 特点 也 可 以 算 做 它 的 优势 ， 所 以 我 们 主要 给 大 家 列举 该 框架 的 几 个 主要 特点 。 
1. 开 发 效率 高 


Hush Framework 基 本 沿用 了 Zend Frameworl 


和 提炼 已 经 日 渐 成 熟 ， 另 外 ， 此 框架 相对 比较 适合 


严谨 的 编码 规范 和 优秀 的 框架 设计 ， 形 成 了 别 
内 程序 员 的 思路 ， 从 而 提高 了 开发 效率 。 


前 面 大 家 已 经 学 习 了 PHP 模 板 引 擎 Smarty 的 用 法 ， 也 简单 了 解 了 PHP 的 官方 框架 Zend Framework， 接 下 来 本 书 将 给 大 家 介绍 一 个 基于 Zend Framework 和 Smarty 之 上 的 强大 的 PHP 


后 ， 在 这 个 框架 的 基础 上 进行 开发 ， 这 个 过 程 我 们 通常 称 为 “框架 选 型 ”。 其 实 ， 在 之 前 的 3.4 节 中 我 们 已 经 介绍 和 分 析 了 四 种 
的 基础 框架 ， 我 们 通过 长 时 间 的 整理 归纳 和 项 目 积累 ， 在 Zend Framework 和 Smarty 的 基础 上 构建 出 了 Hush Framework 这 个 PHP 的 开发 框 
的 ， 接 下 来 我 们 从 几 个 方面 给 大 家 介绍 一 下 这 个 框架 。 


RIER, BI 


BY 


特色 的 MVC 结 构 ; 此 外 ， 本 框架 目前 已 经 被 


国 


2. 运 行 效率 高 
虽然 Zend Framework 的 运行 效率 一 直 为 大 家 所 诉 病 ， 但 是 其 中 最 重要 的 原因 是 类 库 实 在 太 庞大 了 ， 因 此 Hush Framework 只 使 


优化 ， 比 如 URL 的 路 由 逻辑 优化 ，DB 类 的 


3. 可 扩展 性 高 


Hush Framework 的 高 扩 
屋 框 架 的 最 主要 原因 之 一 。 


当然 ， 除 了 以 上 这 些 
等 ， 但 是 由 于 本 书 实例 仅 用 到 框架 中 的 最 基础 的 MVC 代 码 框架 ， 所 以 我 们 后 


H 


法 简化 等 ， 极 大 限度 地 提高 了 整个 框架 的 运行 效率 。 


展 性 得 益 于 Zend Framework 优 秀 的 类 库 设计 ， 松 耦合 的 设计 方法 让 它 能 快速 地 适应 不 同 项 


基础 特点 之 外 ，Hush Framework 还 有 很 多 其 他 的 很 棒 的 特性 ， 比 如 我 们 可 以 
的 介绍 也 将 上 


在 实际 项 目 中 使 用 PHP 语 言 来 编程 。 


3.6.2 ”框架 的 基础 目录 结构 


内 多 个 知名 网 络 公司 所 采 / 


， 经 过 了 多 个 实际 项 目的 考验 


本 


它 的 基础 代码 来 快速 开发 一 个 常见 的 互联 网 应 
El4¢% Hush Framework 的 基 


甘 


， 还 可 以 


了 其 中 几 个 核心 类 库 ， 并 对 其 中 一 些 效率 不 够 高 的 地 方 进行 了 精简 和 


的 需求 ， 这 也 是 为 什么 我 们 会 选择 Hush Framework 来 作为 本 书 实例 的 服务 端 底 


自 带 的 工作 流 模块 来 开发 ERP 系 统 
法 来 给 大 家 讲解 ， 其 中 我 们 也 会 穿插 一 些 PHP 编 程 的 要 点 ， 让 大 家 更 加 了 解 如 何 


想 要 熟悉 一 个 框架 ， 最 好 的 方式 莫 过 于 从 它 的 代码 目录 结构 入 手 ， 下 面 我 们 先 来 讲解 一 下 Hush Framework 的 基础 目录 结构 ， 让 大 家 对 这 个 框架 有 一 个 整体 性 的 认识 。 下 面 便 是 对 这 个 框架 主要 目录 的 


一 个 对 照 ， 我 建议 大 家 使 用 svn 工 
目录 说 明 3-1 
hush-framework 
- hush-app 实例 应 用 程序 目录 
l- bin 可 执行 文件 目录 
l- dat 临时 存储 文件 
|- doc 主要 文档 目录 
l- etc 配置 文件 目录 
|- lib 主要 远 辑 目录 
| |- Ihush 
| 1- Acl ACL 权限 逻辑 类 库 
| l- App 
l | |- Backend 
| | | |- Page 后 台 Controller #4 
| | | |= Remote 后 台 Service ifi 
l | |- Frontend 
l l 1- Page W Controller 逻辑 
| |- Bpm Bpm iE AGE 
I |- Dao 
I |- Apps Apps 库 的 Module/Dao 类 库 
| |- Core Core 库 的 Module/Dao 类 库 
|- tpl 
| - backend 后 台 模 板 文件 
| |- frontend 前 台 模 板 文 件 
|- web 
- backend 后 台 DocumentRoot (站 点 目录 ) 
- frontend 前 台 DocumentRoot (站 点 目录 ) 
- hush-lib 
|- Hush 
- Acl Acl 权限 类 库 
- App App Url Dispatcher 
- Auth 
- Bpm Bpm XJ 
- Cache Cache 类 库 
- Chart 图 像 类 库 
- Crypt Jus X (Rsa) 
- Date 
- Db 数据 库 层 (Module) 类 库 
- Debug 调试 类 
- Document 文档 类 库 
- Examples 一 些 例 子 (主要 针对 Cli 程序 ) 
- Html Html 构建 类 库 
- Http 远程 访问 类 库 
- Json 
- Mail 邮件 收发 类 库 
- Message 消息 类 库 
- Mongo Mongodb 类 库 
- Page AnA (Controller) XJ 
- Process 多 进程 类 库 
- Service 服务 层 (Service) 类 库 
- Session 
- Socket Socket 类 库 
- Util 工具 类 库 
- View 展示 层 (View) XJ 
- hush-pms PHP Message Server 


从 上 述 目录 结构 说 明 中 ， 我 们 可 以 看 到 Hush Framework 的 文件 目录 中 ， 


要 包含 以 下 两 大 目录 。 


到 Hush Framework 的 官方 网 站 (http://code.google.com/p/hush-framework/) 上 把 代码 下 载 到 本 地 来 进行 比 对 阅读 ， 这 样 才 会 达到 比较 好 的 学 习 效果 。 


可 以 把 它 当做 一 个 项 目的 基础 架构 进 


是 本 书 的 重点 之 一 了 ， 接 下 来 我 们 马上 会 对 该 实例 中 的 一 些 主要 


(database.mysql.php) 用 于 设置 数据 库 的 服务 器 分 布 和 分 库 分 表 策 略 等 ; 前 后 台 配 置 文件 (frontend.config.php 和 backend.config.php) 分 别 用 于 配置 前 


控制 ， 也 就 是 MVC 中 的 Controller 部 分 ; 工作 流 模 块 (Bpm 


app/bin 目 录 下 面 就 是 可 执行 程序 的 入 口 ; 数据 操作 模块 (Dao 目录 ) 大 家 应 该 都 


目录 


1.hush-app 


特别 注意 一 下 hush-app 下 面 的 etc、lib、tpl 和 web 四 个 
(1) 配置 目录 (etc) 


配置 目录 (etc) 下 面 放 


(2) 代码 目录 (lib) 


本 目录 是 主要 的 公 


的 都 是 应 用 的 配置 文件 ， 


该 目录 下 的 代码 是 Hush Framework 给 我 们 提供 的 框架 实例 程序 ， 是 一 个 比较 完整 的 互联 网 应 
也 说 过 了 ， 本 书 实例 的 服务 端 程序 就 是 在 本 框架 的 基础 之 上 开发 的 ， 


行 二 次 开发 ; 另外 ， 之 前 


法 和 代码 进行 讲解 。 


实例 ， 包 括 应 


前 端 和 管理 后 台 两 大 部 分 ， 我 们 既 可 以 把 该 实例 当做 一 个 代码 示例 库 来 学 习 和 使 
此 从 某 种 意义 上 来 说 和 这 里 的 实例 程序 是 非常 相似 的 ， 所 以 这 里 应 该 算 


,也 


因为 这 四 个 


录 、 模 板 


录 和 站 点 


录 分 别 是 实例 应 


程序 的 配 


录 、 代 码 


其 中 比较 重 


的 包括 : 


(3) 模板 目录 (tpl) 


此 目录 下 还 分 为 前 台 模 板 目 录 (frontend 目 录 ) 和 后 台 模 板 目 录 (backend 


面 我 们 来 给 大 家 详细 介绍 一 下 。 


类 库 和 钦 辑 代码 目录 ， 现 将 其 中 比较 重要 模块 的 代码 分 目录 列举 如 下 : 权限 控制 模块 (Acl 


局 配置 文件 (global.config.php) 主要 用 于 设置 应 用 | 


的 总 体 配 


， 比 如 路 径 变量 、 类 库 位 


5; SOBRE 


AR) 主要 用 于 前 后 台 | 


的 RBAC 权 限 控制 ;控制 器 模块 (App 目录 ) 


后 台 的 特殊 参数 。 


于 各 个 页 面 的 逻辑 


BR) 用 于 实例 后 台中 工作 流 部 分 的 逻辑 控制 ;可 执行 程序 模块 (Cli 目录 ) FE 
E 常 熟悉 了 ， 这 里 保存 的 是 和 数据 库 操 作 相关 的 所 有 逻辑 ， 也 就 是 MVC 中 的 Model 部 分 。 


制 器 模块 ”中 的 各 个 不 同 控制 器 的 动作 逻辑 (Action) 相对 应 。 


(DocumentRoot) 所 需要 指定 到 的 


IP 


(4) 站 点 目录 (web) 


这 里 面 放 的 都 是 一 些 静态 文件 或 者 独立 的 PHP 代 码 等 ， 此 目录 也 分 为 前 台 站 点 目录 (frontend 目 录 ) 和 后 台 站 点 目录 (backend 


2.hush-lib 目 录 


此 目录 保存 的 是 Hush Framework 的 源 代码 ， 我 们 可 以 看 到 这 
“ 松 耘 合 ” 的 设计 原则 ， 既 便于 理解 又 便于 阅读 ， 是 一 个 比较 值得 提倡 的 代码 封装 方法 。 


至 此 ， 已 经 给 大 家 介绍 了 Hush Framework 框 架 和 应 
Æ (hush-lib) 源码 中 的 模块 和 目录 介绍 ， 


3. 


3x) ， 分 别 


于 存储 应 


实例 前 


后 台 的 Smarty 模 板 ， 这 也 就 是 MVC 中 的 View 部 分 了 ， 这 里 的 模板 和 前 下 


都 是 项 目 可 执行 程序 的 逻辑 代码 ， 另 外 我 们 需要 知道 的 是 hush- 


所 提 到 过 的 “ 控 


录 ) ， 另 外 这 两 个 


录 也 是 HTTP 服 务 器 的 站 点 配置 


3.6.3 ”框架 MVC 思 路 讲解 


fic, Hush Framework 是 一 个 标准 的 MVC 框 架 ，MVC 的 概念 大 家 应 该 都 ] 
(View) 和 控制 器 (Controller) 的 缩写 ,是 目前 业内 最 主流 且 应 上 


1. 低 耦合 性 


MYVC 最 大 的 好 处 之 一 就 是 大 大 降低 了 程序 的 耦合 性 ， 特 别 是 把 视图 


Hx, 


(hush-app) 中 的 重要 代码 目录 ， 这 是 学 习 如 何 使 
由 于 篇 幅 原因 这 里 就 暂时 不 做 介绍 了 ， 有 兴趣 的 读者 可 以 访问 Hush Framework 在 Google Code 的 官方 站 点 ， 查 找 更 多 信息 。 


耳熟能详 了 ， 


有 的 代码 目录 和 Zend Framework 的 结构 非常 一 致 ， 也 就 是 把 每 个 独立 的 模块 代码 都 放 在 各 


Hush Framework 进 行 开发 的 重要 一 步 ， 


由 于 关系 到 本 书生 


要 的 服务 端 底层 框架 的 学 习 ， 我 们 还 是 不 得 不 老 调 重 弹 。MVC 是 模型 (Model) , WE 


泛 的 软件 设计 模式 之 一 ，MVC 


层 和 业务 逻辑 分 开 之 后 ， 让 整个 应 


备 以 下 主 : 


灵活 了 很 多 ; 当 业 务 逻 辑 有 变化 时 ， 我 们 只 需 修改 模型 层 和 控制 器 的 代码 ， 而 无 须 修改 负责 应 


外 观 的 视图 层 。 

2. 高 重用 性 

MVC 的 高 重用 性 主要 体现 在 两 方面 。 一 方面 是 视图 层 的 重用 性 ， 因 为 在 实际 的 项 目 中， 我 们 经 常 需要 修改 应 用 外 观 来 满足 需求 ， 由 了 
界面 ， 满 足 了 软件 高 重用 性 的 要 求 。 另 一 方面 ， 业 务 罗 辑 被 分 为 模型 层 和 控制 器 层 之 后 ， 既 保证 了 核心 数据 结构 的 稳定 性 ， 
实现 多 种 多 样 的 业务 逻辑 。 


对 中 大 型 软件 应 


起 来 更 容易 ， 我 们 


3. 可 维护 性 


MVC 设 计 模式 把 模型 、 视 图 和 控制 器 分 开 ， 实 际 上 也 把 设计 者 、 程 序 员 和 UI 设计 人 员 的 职能 做 了 分 离 。 这 入 


之 前 讨论 的 是 MVC 设 计 模式 中 比较 通 
把 Hush Framework 处 理 客户 端 请 求 的 完整 过 程 通过 加 


程序 的 代码 维护 工作 将 起 到 很 重要 的 作用 。 


的 概念 和 知识 ， 然 而 对 于 不 同 的 框架 来 说 ， 


体 的 实现 方式 却 有 各 


从 图 3-16 中 我 们 可 以 很 清楚 地 看 到 客 


Framework 的 模型 | 


a, Me 


步骤 1: 首先 ，Hush Framework 的 请 求 分 发 器 (Dispatcher) 会 分 析 客户 端 发 送 过 来 的 HTTP 请 求 所 包含 的 信息 ， 并 根据 请 求 的 URL 地 址 来 指定 使 


步骤 2: 接着 ,被 指定 的 控制 器 会 选择 合适 的 模型 类 (Model) 上 
层 的 。 当 然 ， 在 逻辑 处 理 完成 后 ， 控 制 器 还 会 调 


框架 程序 来 处 理 ， 此 时 Hush Framework 就 会 接管 接 下 来 的 工作 。 


户 端 请 求 的 整个 处 理 过 程 ， 在 一 个 标准 的 基于 HTTP 协 议 


形 的 方式 展示 出 来 ， 如 图 3-16 所 示 。 


的 互联 网 应 


环境 中 ， 


视图 


体 的 处 理 流程 一 般 分 为 以 下 几 个 步骤 。 


业务 逻辑 已 经 分 离 出 来 ， 所 以 我 们 不 需要 更 改 逻 辑 就 可 以 调整 应 


录 下 并 尽量 互 不 关联 ， 这 也 比较 符 


希望 大 家 能 好 好 消化 一 下 以 上 内 容 。 至 于 框架 类 


也 增强 了 业务 逻辑 控制 器 的 灵活 性 ， 这 样 我 们 就 可 以 很 好 地 重 


核心 数据 结构 来 


相应 的 控制 器 (Control 


分 工 方式 不 仅 可 以 让 应 用 的 架构 看 起 来 更 清晰 ， 还 便于 软件 维护 时 团队 之 间 的 共同 协作 ， 这 


不 同 的 特色 ， 接 下 来 我 们 就 来 学 习 Hush Framework 中 的 MVC 设 计 思 路 。 为 了 让 大 家 理解 


户 每 次 操作 都 会 致使 浏览 器 向 HTTP 服 务 器 发 送 HTTP 请 求 ， 当 服务 器 接收 到 请 求 之 


er) 来 处 理 该 请 求 。 


持久 层 数据 的 获取 和 存储 ， 并 负责 处 理 该 请 求 的 业务 逻辑 。 此 外 ， 我 们 可 以 看 到 Hush Framework 的 模型 层 是 基于 Zend 
= (View) 来 组 合 出 最 终 的 HTML 代 码 。 


HTML 代码 


«— 


步骤 3: 最 后 ， 服 务 器 会 把 Hush Framework 的 处 理 结果 通过 HTTP 协 议 返 回 


通过 分 析 我 们 会 发 现 ， 实 际 上 Hush Framework 的 MVC 设 计 和 实现 的 思路 还 是 比较 主流 的 ， 和 大 部 分 网 络 应 | 


Dispatcher 


请 求 分 发 器 


Controller 
HPSS 


<—. 


i 


View 


uy 


= 


数据 库 


图 3-16 Hush Framewotk 系 统 处 理 分 析 图 


给 客户 端 程序 来 进行 后 续 的 处 理 。 


3-3 所 示 。 


配置 清单 3-3 etc/app.mapping.ini 


; URL mappings 


; Used by Hush_App Dispatcher class 
; e.g /url/path = PageClassName: :ActionName 


= DebugServer: :indexAction 


/ 
/debug/* = DebugServer: :* 


Framework 的 分 发 器 (Dispatcher) 就 使 用 了 独 有 的 快速 分 发 逻辑 ， 大 大 提高 了 程序 的 运行 效率 ; 另外 ， 不 仅 支持 常见 的 URL 路 由 分 发 模式 ， 还 支持 通过 “路 
的 配置 ， 映 射 文件 代码 如 配置 清 


的 MVC 框 架 的 思路 也 比较 相似 ， 不 过 其 中 还 是 有 不 少 独特 的 亮点 。 


Hush 
Framework 
ERE 


Model 
楼 型 层 


Zend Framework 
EEG 


比如 Hush 
映射 文件 ”这 种 更 直观 的 方式 来 进行 更 精细 


另外 ，Hush Framework 的 模型 层 使 


了 Zend Framework 作 为 底层 框架 ， 


沿用 了 其 完善 的 DB 模型 层 封装 和 方法 的 设计 ， 并 使 


己 独特 的 思路 封装 成 Hush Framework 的 DAO 基 类 ， 让 建立 在 基 类 


之 上 的 持久 层 操作 更 加 简便 、 高 效 。 在 接 下 来 的 3.6.4 节 中 ， 我 们 将 通过 实例 来 讲解 Hush Framework 持 久 ， 
3.6.4 框架 MVC 实 例 分 析 


层 的 用 法 。 


通过 前 面 两 节 的 学 习 ， 大 家 应 该 对 Hush Framework 框 架 的 理论 基础 有 了 一 定 的 认识 ， 但 是 理论 还 是 需要 通过 实践 来 证 明 ， 


本 节 中 我 人 
是 如 何 使 


] 将 会 围绕 着 框架 实例 中 与 MVC 分 层 开发 相关 的 实例 代码 为 大 家 做 进一步 的 讲解 。 下 面 我 们 会 使 
MVC 的 分 层 思 路 来 进行 编程 的 ， 我 们 先 来 看 一 下 这 个 界面 的 截图 ， 如 图 3-17 所 示 。 


真正 学 会 如 何 运 


该 框架 进行 开发 ， 光 靠 理论 知识 是 远 远 不 够 的 ， 所 以 在 


框架 实例 中 的 “后 台 登 录 ” 这 个 界面 的 完整 逻辑 ， 来 给 大 家 讲解 一 下 在 Hush Framework 中 我 们 


Rush kamenon 。 后 台 管 理 系 统 


hush Framework sandbox 


FPS: 


HUE AS: 


weQdw 
au - 


图 3-17 框架 实例 后 人 台 登 录 界面 


以 上 是 在 浏览 器 中 打开 框架 实例 的 后 台 站 点 时 看 到 的 界面 ， 也 就 是 后 台 的 登录 界面 。 这 里 我 们 可 以 看 到 浏览 器 中 的 地 址 是 “http://hf-be/auth/”， 按 照 前 面 所 介绍 的 Hush Framework 的 应 用 目录 中 
所 提 及 的 ， 对 应 的 控制 器 类 应 位 于 lib/Ihush/App/Backend/Page/AuthPage.php 文 件 中 。 至 此 ， 既 然 已 经 找到 分 析 框 架 MVC 用 法 的 “突破 口 ”， 那 么 我 们 就 从 这 里 开始 分 析 吧 。 


我 们 先 来 看 看 AuthPage.php 文 件 中 的 AuthPage 类 ， 此 类 继承 自 Ihush_App_Backend_Page 类 ( 即 整个 实例 应 用 的 后 台 控制 器 基 类 ) ， 其 中 包含 多 个 以 Action 为 后 缀 的 方法 ， 分 别 对 应 于 “后 台 登 
录 ” 界 面 的 几 个 逻辑 ， 整 个 类 的 写法 都 是 面向 对 象 的， 大 家 可 以 对 照 前 面 3.1.4 节 的 内 容 理解 一 下 ， 关 于 其 中 涉及 的 MVC 分 层 思路 ， 下 面 我 们 会 把 这 三 层 的 相关 代码 提取 出 来 ， 分 别 给 大 家 讲解 一 下 。 


1. 控 制 器 (Controller) 


控制 器 简单 来 说 就 是 页 面 的 逻辑 ， 在 Hush Framework 中 我 们 通常 使 用 Page (页 面 ) 来 表示 通常 意义 的 Controller， 因 为 对 于 网 络 应 用 来 说 Page 比 Controller 更 好 理解 ， 此 外 ， 我 们 还 需要 知道 Hush 
Framework 使 用 的 是 REST 格 式 的 URL 路 径 结 构 ， 自 域名 之 后 的 URL 路 径 第 一 个 表示 的 是 控制 器 的 名 称 ， 第 二 个 则 是 控制 器 的 动作 ， 也 就 是 我 们 通常 所 称 的 Action， 比 如 登录 界面 的 路 径 为 “/auth/”， 其 对 
应 的 逻辑 就 可 以 在 AuthPage.php 文 件 中 AuthPage 类 的 indexAction 方 法 中 找到 ， 这 里 需要 注意 的 是 当前 路 径 如 果 为 空 ， 我 们 则 会 用 index 来 代替。 代码 清单 3-21 就 是 AuthPage 类 的 完整 实现 ， 大 家 可 以 参 
考 注 释 来 阅读 代码 。 


代码 清单 ”3-21 


/ ** 
* @package Ihush App Backend 
*/ 


class AuthPage extends Ihush App Backend Page 
{ 
public function indexAction () 


// TODO : 默认 使 用 index.tp1 作 为 Rction 的 模板 
$ 
public function loginAction () 
{ 


// 用 户 名 /密码 /验证 码 均 不 能 为 空 

if (!$this-»param('username') || 
!Sthis->param('password') || 
!$this-»param('securitycode')) { 
$this->addError ('login.notempty') ; 


l 

// 验证 码 必 须 是 正确 的 

elseif (strcasecmp ($this->param ('securitycode'),$this->session ('securitycode'))) { 
$this->addError ('common.scodeerr'); 


l 
// 通过 参数 验证 
if ($this->noError()) { 
// 使 用 DAO 类 的 验证 方法 
$aclUserDao = $this->dao->load('Core User"); 
Sadmin = $aclUserDao->authenticate ($this-»param('username'), 
Sthis-»param('password')); 
// 登录 失败 ( 找 不 到 用 户 ) 
if (!Sadmin) { 
Sthis-»addError ('login.nouser') ; 


l 

// 登录 失败 

elseif (is_int($admin)) { 
Sthis-»addError ('login.failed'); 


} 
// 登录 成 功 
else ( 
// 是 否 是 超级 用 户 
Sadmin['sa'] = strcasecmp ($admin['name'], $this->sa) ? false : true; 
// 保存 登录 用 户 信 息 到 会 话 
$this->session('admin', $admin); 
// 跳 转 至 首页 
$this->forward ($this->root) ; 
} 


} 
// 登录 失败 则 显示 登录 界面 
Sthis-»render ('auth/index.tpl'); 


i 
public function logoutAction () 
{ 


从 以 上 的 
' 用 户 登 出 逻辑 ”， 以 上 功能 的 基本 逻辑 和 涉及 的 PHP 语 法 这 里 就 不 做 解释 了 ， 接 下 来 我 们 会 给 大 家 分 析 一 下 这 几 个 Action 方 法 中 比较 和 


辑 和 


if ($this->session('admin')) | 
// 用 户 登 出 ， 清 除 用 户 会 话 信息 


$this->session('admin', 


"UN 


l 
Sthis-»forward ($this->root) ; 


AuthPage 控 制 器 类 的 代码 。 


(1) 使 


首先 我 们 需要 知道 的 是 在 Hush Framework 中 使 


们 可 以 根据 这 个 规则 分 析出 其 对 应 模板 是 tpl/backend/template/auth 目 录 下 的 index.tpl; 另外 一 种 方式 是 通过 render 手 动 设置 模板 ， 这 也 正 是 在 loginAction 中 最 


清单 3-22 中 的 写法 。 


代码 清单 ”3-22 


// 登录 失败 则 显示 登录 界面 
$this->render ('auth/index.tpl'); 


这 行 代码 的 逻辑 其 实 非常 容易 理解 ， 就 如 同 注释 中 描述 的 一 样 ， 当 


(2 


par: 


) 使 


am 方法 是 : 


发 中 最 常 


代码 清单 ”3-23 


param 方 法 获取 URL 参 数 


的 方法 之 一 ， 该 方法 一 般 


代码 中 我 们 可 以 看 出 ， 在 控制 器 类 AuthPage 中 有 三 个 Action 方 法 ,分 别 是 indexAction、loginAction 和 IlogoutAction， 这 些 方 法 对 应 的 三 个 功能 分 别 是 “展示 登录 界面 ”、 
要 的 知识 点 ， 学 习 并 理解 这 些 知识 点 后 ， 有 助 于 我 们 分 析 


render 方 法 展示 模板 


户 登录 失败 后 ， 程 序 还 是 应 该 展示 出 登录 页 面 给 用 户 重新 填写 登录 名 和 密码 。 


// 获取 GET 或 者 POST 过 来 的 username 参 数值 
$username = $this->param('username'); 


// 设置 Username 参 数值 为 james 


$this-»param('username', 


(3) 使 


AREA, EARRA 


(4) 使 


'james'); 


addError 方 法 处 理 错误 信息 


有 提交 之 后 ， 我 们 会 先 做 一 些 字段 的 判断 ， 比 如 


load 方 法 来 加 载 DAO 类 


模板 有 两 种 方式 : 首先 是 默认 方式 ， 此 种 方式 是 按照 “模板 根 目录 /Controller 名 /Action 名 .tpl” 这 样 的 规则 来 放置 的 ， 因 此 对 于 in 


PRE 


dexAction 来 说 我 


后 的 那 行 代码 所 做 的 村 


框架 已 经 帮助 我 们 把 Controller 层 中 如 何 使 用 Model 层 的 方法 封装 好 了 ， 那 就 是 这 里 所 说 的 load 方 法 ， 我 们 可 以 使 用 如 下 代码 获取 任意 一 个 DAO 类 ， 如 代码 清单 3-24 所 示 。 


代码 清单 ”3-24 

SaclUserDao = $this->dao->load( "Core User'); 

$admin = $aclUserDao-»authenticate ($this-»param('username'), $this->param('password')); 

以 上 代码 取 自 于 loginAction 中 的 部 分 逻辑 : 首先 ， 初 始 化 了 Core_User 的 DAO 类 供 我 们 使 用 ; 然后 ， 使 用 该 类 中 的 authenticate 方 法 判断 上 


做 详细 分 析 。 


小 贴 士 :前面 提 弄 
(5) 使 
在 一 个 互联 网 应 


代码 清单 


的 DAO 是 数据 访问 对 象 (Data Access Objects) 的 缩写 ， 该 对 象 常 被 用 于 进行 数据 库 层面 的 各 种 数据 操作 ， 后 面 我 们 会 经 常 提 到 。 


forward 进 行 页 面 跳 转 


3-25 


中 ， 页 面 跳 转 是 再 常见 不 过 的 对 


Sthis-»session('admin', $admin); 
$this->forward ($this->root) ; 


(6) 使 


会 话 的 概念 相信 有 些 网 络 开发 基础 的 朋友 都 应 该 清楚 ， 


Session 函数 操控 会 话 


会 话 (Session) 来 保存 


为 HTTP 是 无 状态 的 ， 所 以 我 们 一 般 会 使 F 


码 ， 如 代码 清单 3-26 所 示 。 


代码 清单 


// 保存 登录 用 户 信 息 到 Session 


3-26 


$this->session('admin', $admin); 


// 


$this->session('admin', 


2. 视 图 层 


(View) 


图 层 主 


视 


对 应 的 模板 ， 


代码 清单 


3-27 


<html> 
<head> 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8" /> 
«title»Jf P BR</title> 


用 户 登 出 ， 清 除 用 户 会 话 信息 
‘Vi 


情 了 ， 这 里 我 们 也 能 找到 相应 的 示例 代码 ， 也 就 是 登录 成 功 之 后 跳 转 到 首页 的 逻辑 ， 如 代码 清单 3-25 所 示 。 


负责 的 是 对 应 控制 器 逻辑 的 展示 ， 一 般 来 说 是 由 HTML 语 法 和 Smarty 变 量 构成 的 。 根 据 前 面 介绍 的 关于 Hush Framework 中 的 两 种 模板 使 
也 就 是 tpl/backend/template/auth 中 的 index.tpl 模 板 文 件 ， 如 代码 清单 3-27 所 示 。 


有 情 ， 可 参考 代码 


获得 GET 或 者 POST 过 来 的 URL 参 数 ; 另外 ， 如 果 这 个 函数 带 两 个 参数 ， 则 是 设置 对 应 URL 参 数 的 值 。 示 例 代 码 如 代码 清单 3-23 所 示 。 


户 名 和 密码 是 否 为 空 等 ， 如 果 这 些 验证 没有 通过 ， 就 要 给 页 面 传递 一 些 错误 信息 ， 而 addError 方 法 就 是 做 这 个 事情 的 ， 比 如 前 
面 实例 中 的 代码 “$this->addError (‘login.notempty') ; ”就 是 用 来 显示 错误 信息 的 ， 另 外 对 应 的 错误 信息 “login.notempty” 我 们 可 以 在 “etc/backend.errors.ini” 文 件 中 找到 。 


户 是 否 登录 成 功 ， 这 个 地 方 的 逻辑 我 们 会 在 下 面 的 模型 层 中 


户 相 关 的 信息 ， 在 loginAction 和 logoutAction 中 我 们 都 可 以 看 到 相关 的 代 


方式 ， 我 们 可 以 “顺藤摸瓜 ”找到 indexAction 


"(S root]css/main.css" rel="stylesheet" type="text/css" /> 
{$_root}css/login.css" rel="stylesheet" type="text/css" /> 


{literal} 
<script type="text/javascript"> 
if (self!-top) {top.location=self. location; } 
</script> 
{/literal} 
</head> 
<body> 
<div class="Llogin-body"> 
<div class="login-con"> 
<hl><img src="{$_root}img/logo_s.gif" /><span>) 6 EJ # #</span></h1> 
<div class="login"> 
{include file="frame/error.tpl"} 
<form action="{$ root}auth/login" method=". 


<input type="hidden” name="go" val "/» 
<input type="hidden" name-"do" value-"login"/» 
«ul» 
<li> 
<label>/f] P 4: </label> 
<input type="text" class="text" name="username"/> 
</li> 
<li> 
<label># 45: </label> 
<input type="password" class="text" name="password"/> 
</li> 
<li> 
<label> 验 证 码 : </label> 
<input type="text" class="text" style="width: 50px;margin-right:5px; 
text-transform: uppercase;" id="securitycode" 
name-"securitycode" autocomplete-"off"/» 
<img id-"securityimg" src-"($ root)app/scode/image.php" 
alt=" 看 不 清 ? $A RA" 
onClick="this.src=this.src+'?'" /> 
</li> 
<li> 
<input type="submit" onclick="this.form. submit ();" 
class="submit" value=" 登 录 "” name="sm1"/> 
</li> 
</ul> 
</form> 
</div> 
</div> 
</div> 
</body> 
</html> 


以 上 代码 大 部 分 是 比较 简单 的 HTML 语 法 ， 穿 插 了 一 些 Smarty 的 变量 ， 比 如 “{$_root}” 就 是 设置 好 的 全 局 的 Smarty 的 变量 ， 代 表 项 目 URL 的 根 路 径 ， 默 认 是 “/”。 另 外 ， 在 该 模板 里 我 们 还 看 到 了 登 
录 表 单 的 代码 “<form action="{$_root}jauth/login"method="post">”， 这 里 我 们 可 以 发 现 该 登录 表单 将 会 被 提交 至 “/auth/login” 路 径 ， 其 对 应 逻辑 就 在 前 面 我 们 分 析 过 的 控制 层 中 AuthPage 类 的 
loginAction 方 法 里 。 


3. 模 型 层 (Model) 


模型 层 是 MVC 三 层 中 最 接近 数据 库 的 一 层 ， 里 面 放 的 是 数据 操作 的 逻辑 ， 也 就 是 说 我 们 常 说 的 CRUD 操 作 ， 这 部 分 也 是 我 们 需要 
到 了 DAO 类 Core_User 里 面 的 authenticate 方 法 ， 下 面 我 们 截取 Core_User 里 面 的 相关 代码 给 大 家 讲解 一 下 ， 见 代码 清单 3-28。 


回 


点 了 解 的 。 在 前 面 的 登录 界面 的 示例 中 ， 我 们 了 解 到 loginAction 中 使 


小 贴 士 : CRUD 操 作 是 添加 (Create) 、 查 询 (Retrieve) 、 更 新 (Update) 和 删除 (Delete) 的 缩写 ， 也 就 是 我 们 常 说 的 “增删 查 改 ”方法 ， 这 几 个 操作 基本 包含 了 数据 操作 类 DAO 绝 大 部 分 的 使 用 方 
式 ， 后 面 我 们 也 会 经 常 提 到 。 


代码 清单 3-28 


/** 
* (package Ihush Dao Core 
#7, 
class Core User extends Ihush Dao Core 
{ 
/** 
* 设置 表 名 
* @static 
z 
const TABLE NAME = 'user'; 
pir = 
* 设置 主键 
* @static 
A 
const TABLE PRIM 
/** = 
* Initialize 
ued 
public function _ init () 
{ 


'id'; 


Sthis->tl = self::TABLE NAME; 

$this-»t2 = Core Role::TABLE NAME; 
$this-»rsh = Core UserRole::TABLE NAME; 
// 绑 定 常用 CRUD 操 作 

$this-> bindTable ($this->t1); 


} 
Viki 
* 登录 验证 方法 
* Quses Used by user login process 
* @param string Suser 用 户 名 
* @param string $pass 密码 
* @return bool or array 
* 
/ 
public function authenticate ($user, $pass) 
{ 
$sql = $this->select () 
-»from($this-»tl, "*") 
—>where ("name = ?", $user); 
$user = $this->dbr ()->fetchRow ($sql); 
if (!$user['id'] || !$user['pass']) return false; 
if (strcmp ($user['pass'], Hush_Util::md5($pass))) return $user['id']; 
$sql = $this->select () 
-»from(Sthis-»t2, "*") 
—>join($this->rsh, "($this->t2).id = {$this->rsh}.role_id", null) 
->where ("($this->rsh).user_id = ?", $user['id']); d 
$roles = $this->dbr ()->fetchA11 ($sql); 
if (!sizeof($roles)) return false; 
foreach ($roles as $role) ( 
Suser['role'][] = $role['id']; 
Suser['priv'][] = $role['alias']; 
} 


return $user; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


接 下 来 ， 我 们 来 分 析 一 下 Core_User 类 中 使 用 到 的 几 个 功能 要 点 ， 并 以 此 为 实例 给 大 家 介绍 一 下 Hush Framework 中 模型 层 的 核心 用 法 ， 也 就 是 框架 DAO 基 类 中 已 经 封装 好 的 数据 库 常见 操作 的 编码 和 
使 用 。 


(1) DAO 类 的 初始 化 


在 Hush Framework 中 使 用 DAO 类 ， 首 先 需要 配置 一 个 和 数据 表 相 对 应 的 DAO 类 ， 这 个 过 程 我 们 通常 称 为 DAO 类 的 初始 化 。 其 实 配 置 一 个 DAO 类 是 非常 方便 的 ， 因 为 框架 DAO 基 类 已 经 帮 有 我 们 封装 好 


了 绝 大 部 分 DAO 类 所 需要 的 逻辑 和 方法 ， 所 以 初始 化 起 来 非常 简单 。 代 码 清单 3-29 就 是 一 个 最 简单 的 DAO 类 的 范例 模板 。 


代码 清单 3-29 


// DibName 为 数据 库 名 
// TableName 为 数据 表 名 
class DbName TableName extends Dao DbName ( 
// 配置 表 名 
const TABLE NAME = ' TableName '; 
// 配置 主键 名 
const TABLE PRIM = 'PrimaryKey'; 
// 初始 化 操作 
public function _ init () { 
// 绑 定 常用 的 CRUD 操 作 
Sthis-> bindTable(TABLE NAME); 
} 


我 们 可 以 看 到 ， 区 区 几 行 代码 就 已 经 把 一 个 DAO 类 写 好 了 。 以 上 代码 中 的 DbName 表 示 数 据 库 名 ，TableName 表 示 表 名 ，PrimaryKey 则 表示 主键 名 ，_init 是 初始 化 方法 ，_bindTable 主 要 用 于 绑 定 


上 


CRUD 方 法 ， 也 就 是 说， 初始 化 之 后 我 们 就 可 以 直接 使 用 这 个 DAO 类 来 进行 “增删 查 改 ” 操 作 了 。 


es, 


P 


(2) DAO 类 中 的 查询 方法 


查询 应 该 是 数据 库 最 主要 的 用 途 之 一 ， 这 里 我 们 会 重点 讲解 在 Hush Framework 的 DAO 类 中 使 用 查询 的 要 点 。 从 前 面 提 到 的 Core_User 数 据 操 作 类 中 的 authenticate 方 法 中 我 们 可 以 看 到 在 DAO 类 中 经 
使 用 到 的 查询 (select) 方法 的 使 用 范例 ， 包 括 普通 查询 和 表 关 联 查 询 ， 示 例 见 代码 清单 3-30。 


代码 清单 ”3-30 


joi 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 普通 查询 u 
$sql = Sthis->select () 
-»from($this-»tl, "*") 
-»where ("name = ?", $user); 
$user = $this-—>dbr () ->fetchRow ($sql) ; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 表 关 联 查询 
$sql = Sthis->select () 
-»from($this-»t2, "*") 
->join($this->rsh, "{$this->t2}.id = {$this->rsh}. role_id", null) 
->where ("{$this->rsh}.user_ id = ?", Suser['id']); 
$roles = $this->dbr()->fetchAll ($sql); 


在 Hush Framework 中 ， 我 们 可 以 使 用 和 Zend Framework 类 似 的 方式 来 “拼装 ”数据 库 SQL 查 询 语句 ， 其 代码 语法 还 是 比较 容易 理解 的 ， 我 们 可 以 把 其 中 的 select 方 法 、from 方 法 、where 方 法 以 及 
n 方 法 分 别 理解 为 SQL 语句 中 的 SELECT、FROM、WHERE 以 及 JOIN 这 几 个 关键 词 ， 理 解 起 来 会 更 加 清晰 。 当 然 除了 以 上 这 几 个 方法 之 外 ， 框 架 底 层 还 提供 了 LIMIT、GROUP BY 和 ORDER BY 等 常用 SQL 


语句 的 对 应 方法 。 比 如 代码 清单 3-31 中 列举 的 就 是 一 些 相对 复杂 的 SQL 语句 所 对 应 的 PHP 代 码 的 写法 。 


代码 清单 3-31 


// 对 应 标准 SQL: 
// SELECT COUNT (id) AS count id 


// FROM foo 
// GROUP BY bar, baz 
// HAVING count_id > "1" 


$select = $db->select () 
-»from('foo', 'COUNT(id) AS count_id') 
-»group('bar, baz') B 
-^»having('count id > ?', 1); 

// 对 应 标准 SQL: 

// SELECT * FROM round table 


// ORDER BY noble title DESC, first name ASC 
$select = $db-»select(); 
-»from('round table', '*') 


->order ('noble title DESC!) 
-»order('first name'); 


当然 ， 我 们 需要 理解 Hush Framework 的 这 种 使 用 方法 来 蔡 代 SQL 语 句 的 做 法 ， 因 为 对 于 不 同 的 数据 库 ， 查 询 语句 区 别 是 比较 大 的 ， 如 果 没 有 一 个 很 好 的 通用 SQL 语 句 的 引擎 很 难 做 到 良好 的 通用 性 ， 


然而 这 却 恰 恰 是 本 框架 的 优势 所 在 ; 正 是 因为 有 底层 的 Zend_Db 来 提供 强大 的 基础 ， 才 能 让 Hush Framework 的 模型 层 运转 得 更 加 得 心 应 手 。 为 了 说 明 这 点 ， 我 们 以 代码 清单 3-32 为 例 ， 可 以 看 到 同样 的 


DAO 查 询 语句 在 不 同 的 数据 库 中 被 解释 成 了 不 同 的 SQL;， 这 样 我 们 就 不 需要 关心 应 用 所 使 用 的 数据 库 类 型 ， 简 便 地 写 出 通用 型 的 代码 ， 大 大 提高 了 模型 层 代码 的 重用 性 。 


代码 清单 3-32 


// 在 MySQL/PostgreSQL/SQLite 中 ， 对 应 SQL 如 下 : 
// SELECT * FROM foo 


// ORDER BY id ASC 
// LIMIT 10 
// 


// & Microsoft SQL 中 ， 对 应 SQL 如 下 : 
// SELECT TOP 10 * FROM FOO 
// ORDER BY id ASC 
$select = $db->select () 
-»from('foo', '*!) 
->order ('id') 
-»limit(10); 


此 外 ， 我 们 还 需要 注意 一 点 ，Hush Framework 中 的 数据 库 类 都 是 支持 读 写 分 离 的 ， 因 此 这 里 我 们 使 用 “dbr () -»fetchRow (http://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...) ”方法 (dbr 是 只 读数 据 库 db-read 的 缩写 ) 来 表示 从 “ 读 库 ”中 获取 内 容 ， 一 般 来 说 数据 查询 操作 中 的 绝 大 部 分 情况 都 会 


使 


此 方法 ; 当然 与 之 相对 的 ， 如 果 我 们 要 写 入 数据 ， 则 应 该 使 用 dbw 方 法 来 操作 “ 写 库 ”， 比 如 “dbw () ->delete (http://www.hzcourse.com/resource/readBook? 


path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...) ”就 是 在 “ 写 库 ” 中 删除 信息 的 写法 。 


(3) DAO 类 中 的 CRUD 方 法 


前 面 我 们 已 经 介绍 了 DAO 类 中 查询 操作 的 用 法 ， 以 及 Hush Framework 中 对 于 数据 库 读 写 分 离 用 法 的 使 用 要 点 ， 对 于 查询 操作 来 说 我 们 应 该 使 用 读 库 ， 但 是 对 于 CRUD 中 的 其 他 几 种 操作 来 说 就 应 该 使 


写 库 了 ， 也 就 是 使 用 “dbw () ”方法 进行 调用 ， 下 面 我 们 把 除了 select 之 外 的 几 种 方法 给 大 家 介绍 一 下 。 


似 


:create 方法 : 此 方法 用 于 创建 数据 ， 只 要 传 入 的 是 包含 数据 的 散 列 数组 ， 我 们 就 可 以 在 数据 表 中 添加 一 条 记录 。 这 里 需要 注意 的 是 ， 我 们 在 CRUD 方 法 中 传递 的 数据 格式 经 常 是 类 


“array (keyl=>valuel , key2=>value2http://www-hzcourse.com/resource /teadBook?path= /openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...) ”格式 的 数组 ，key 是 键 名 ， 对 应 的 是 数据 表 的 字 


段 名 ， 而 value 则 是 数据 ， 代 表 的 是 对 应 键 名 的 数据 。 


:exist 方法 : 此 方法 用 于 来 检测 数据 是 否 存在 ， 一 般 来 说 我 们 可 以 传 入 主键 值 进行 判断 ， 当 然 如 果 我 们 需要 根据 其 他 字段 的 值 来 进行 判断 也 是 可 以 的 ， 只 需要 在 第 二 个 参数 传 入 对 应 字段 名 即 可 。 


“ read 方 法 : 此 方法 也 是 和 主键 相关 的 ， 用 于 读 取 与 对 应 主键 相关 的 数据 行 。 因 为 此 方法 不 需要 组 装 SQL， 使 用 起 来 比 select 方 法 简单 许多 ， 所 以 在 获取 与 主键 有 关 的 数据 行 的 情况 下 我 们 常用 它 来 替代 
select 方 法 。 如 果 不 使 用 主键 ， 我 们 也 可 以 在 第 二 个 参数 传 入 对 应 字段 名 。 


: update 方法 : 此 方法 用 于 更 新 数据 行 ， 既 可 直接 传 入 带 主键 的 数组 进行 更 新 (此 种 情况 将 会 按照 主键 值 更 新 对 应 数据 行 ) 。 当 然 ， 我 们 也 可 以 在 第 二 个 参数 传 入 where 语 句 进行 更 新 。 
: delete 方 法 : 此 方法 用 于 删除 数据 行 ， 与 前 面 的 update 方 法 类 似 ， 我 们 既 可 直接 传 入 主键 值 进行 删除 (此 种 情况 将 会 按照 主键 值 删除 对 应 行 ) 。 当 然 ， 我们 也 可 以 在 第 二 个 参数 传 入 对 应 字段 名 。 


:replace 方法 : 此 方法 用 于 替换 数据 行 ， 在 MySQL 数据 库 中 比较 常用 ， 一 般 我 们 替换 的 数据 行 也 是 和 主键 有 关系 的 ， 或 者 是 组 合 型 主键 。 


到 这 里 ， 我 们 已 经 把 整个 代码 示例 “登录 界面 ”的 逻辑 介绍 完了 ， 同 时 也 把 Hush Framework 中 如 何 使 用 MVC 的 思路 来 进行 编程 的 基本 方法 讲 了 一 遍 ， 现 在 大 家 应 该 对 如 何 使 用 Hush Framework 来 进 
行 开发 心里 有 数 了 吧 。 由 于 Hush Framework 是 完全 面向 对 象 的 ， 这 里 大 家 还 可 以 学 到 许多 PHP 语 言 中 的 面向 对 象 编程 的 技巧 。 当 然 最 好 的 学 习 方法 就 是 动手 ， 我 建议 大 家 把 框架 的 实例 代码 架设 起 来 ， 然 
后 直接 动手 边 调试 边 学 习 ， 以 达到 “学 以 致 用 ”的 最 佳 效 果 。 另 外 ， 关 于 如 何 获 取 Hush Framework 框 架 源码 以 及 如 何 部 署 源码 实例 的 内 容 ， 我 们 会 在 附录 A 中 给 大 家 做 详细 介绍 。 
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本 章 中 我 们 比较 全 面 地 介绍 了 使 用 PHP 语 言 进行 开发 的 几 个 方面 。 从 最 基本 的 PHP 语 法 、 语 言 特点 ， 到 PHP 面 向 对 象 编程 思路 、 常 用 开发 环境 的 介绍 ， 再 到 PHP 配 套 开发 组 件 (Apache 和 MySQL 等 ) 
和 主流 开发 框架 的 分 析 和 使 用 ， 如 果 大 家 能 够 把 本 章 所 介绍 的 这 些 知 识 全 部 掌握 ， 那 么 可 以 说 我 们 就 已 经 具备 了 使 用 PHP 语 言 进 行 互 联网 项 目 开 发 的 基本 条 件 ， 接 下 来 还 需要 进一步 学 习 的 就 是 实战 经 验 
了 。 


第 4 章 ”实例 产品 设计 


通过 前 面 的 章节 我 们 已 经 学 习 了 Android 客 户 端 开发 以 及 PHP 服 务 端 开 发 的 基础 内 容 ， 在 本 书 接 下 来 的 章节 中 ， 我 们 将 通过 一 个 完整 的 项 目 实例 来 让 大 家 进一步 熟悉 Android 结 合 PHP 的 互联 网 应 
发 技巧 。 


In 


IF 


和 大 部 分 的 软件 项 目 一 样 ， 首 先 我 们 需要 做 一 个 需求 分 析 ， 做 任何 事情 总 需要 有 一 个 理由 吧 。 为 什么 我 们 会 选择 “ 微 博 应 用 ”作为 本 书 的 项 目 实例 呢 ? 在 动手 开发 之 前 我 们 还 需要 做 些 什么 准备 呢 ? 本 
章 的 内 容 将 帮助 我 们 解决 以 上 这 些 疑问 。 


第 4 章 ”实例 产品 设计 


通过 前 面 的 章节 我 们 已 经 学 习 了 Android 客 户 端 开发 以 及 PHP 服 务 端 开 发 的 基础 内 容 ， 在 本 书 接 下 来 的 章节 中 ， 我 们 将 通过 一 个 完整 的 项 目 实例 来 让 大 家 进一步 熟悉 Android 结 合 PHP 的 互联 网 应 有 
发 技巧 。 


In 


IF 


和 大 部 分 的 软件 项 目 一 样 ， 首 先 我 们 需要 做 一 个 需求 分 析 ， 做 任何 事情 总 需要 有 一 个 理由 吧 。 为 什么 我 们 会 选择 “ 微 博 应 用 ”作为 本 书 的 项 目 实例 呢 ? 在 动手 开发 之 前 我 们 还 需要 做 些 什 么 准备 呢 ? 本 
章 的 内 容 将 帮助 我 们 解决 以 上 这 些 疑问 。 


41 为 何 选择 微 博 


其 实 我 们 都 知道 ， 自 2010 年 “ 微 博 元 年 ”以 来 ， 这 几 年 中 国 互联 网 领域 最 火 的 关键 词 就 是 “ 微 博 ”这 两 个 字 。 这 种 新 兴 的 媒体 工具 现在 已 经 完全 被 广大 的 用 户 群体 所 接受 ， 并 且 正 在 慢 慢 改变 着 我 们 接 
受信 息 的 习惯 。 为 什么 微 博 能 有 这 么 大 的 影响 力 呢 ? 我们 来 简单 分 析 一 下 微 博 应 用 的 几 个 特点 : 


“ 便捷 性 。“ 微 博 ” 简 单 来 说 就 是 “博客 ”的 便捷 版 。 微 博 包含 的 信息 量 比较 小 ， 与 移动 客户 端 结 合 紧密 ， 还 支持 直接 拍照 上 传 等 新 颖 的 功能 ， 使 用 起 来 比 博客 更 方便 、 有 趣 ， 这 也 是 微 博之 所 以 能 够 
成 功 的 根本 因素 之 一 。 


“ 即时 性 。 正 是 由 于 微 博 的 便捷 性 ， 使 用 户 可 以 随时 随地 自由 地 发 布 信息 ， 这 样 也 保证 了 微 博 上 的 信息 都 是 非常 及 时 的 ， 现 在 甚至 出 现 了 “ 微 博 直播 ”这 样 的 形式 ， 使 得 作者 和 读者 之 间 的 距离 更 近 


: 原创 性 。 由 于 发 布 微 博 十 分 简单 ， 这 也 极 大 地 激发 了 微 博 博 主 们 的 “生产 力 ”; 也 正 是 因为 便捷 ， 微 博 特 别 受 名 人 和 老板 们 的 追捧 ， 而 他 们 的 积极 加 入 ， 也 进一步 提高 了 微 博 受 欢迎 的 程度 。 


“ 传播 性 。 首 先 在 微 博 上 用 户 可 以 在 短 时 间 内 发 布 更 多 的 信息 ; 其 次 微 博 特有 的 转发 功能 也 加 快 了 消息 在 人 与 人 之 间 的 传播 速度 ; 再 次 比较 人 性 化 的 是 ， 微 博 上 的 信息 是 可 归 类 的 ， 用 户 可 以 只 关注 感 
兴趣 的 信息 ， 这 样 一 来 也 不 至 于 信息 泛滥 。 


当然 ， 微 博 产品 能 在 短 时 间 内 获得 如 此 大 的 成 功 ， 其 原因 绝 不 仅仅 只 有 以 上 几 点 ; 但 是 不 可 否认 的 是 ， 如 果 不 是 借 着 这 波 移动 互联 网 的 热潮 ， 微 博 绝对 不 可 能 发 展 得 如 此 之 快 ! 因此 从 某 种 程度 上 来 
说 ，“ 微 博 ” 和 “移动 互联 网 ”这 两 个 词 之 间 有 着 相当 密切 的 联系 ; 而 “ 微 博 ” 这 个 产品 身上 也 带 着 许多 “移动 互联 网 ”的 特征 ; 这 也 正 是 我 们 选择 “ 微 博 ” 应 用 作为 本 书 的 重点 实例 的 最 主要 原因 之 一 。 
另外 ， 作 为 当前 最 热门 的 网 络 应 用 之 一 ， 大 家 应 该 对 如 何 完成 一 个 微 博 应 用 比较 感 兴趣 吧 。 


此 外 ， 为 了 达到 最 好 的 学 习 效 果 ， 本 书 将 把 微 博 应 
服务 端 和 客户 端 开 发 的 架构 设计 和 编程 技巧 ， 还 可 以 了 
博 实例 细 分 为 若干 个 小 实例 ， 力 求 覆盖 尽量 可 能 多 的 功 


42 开发 前 的 准备 

通过 上 节 的 介绍 ， 我 们 已 经 搞 清 楚 了 “为 何 选择 微 
有 些许 的 担忧; 期 待 的 原因 自然 不 用 说 ， 如 果 没有 期 待 
个 未 知事 物 时 ， 心 里 自然 会 有 一 些 莫名 的 丽 惧 ， 但 是 如 


的 开发 作为 一 个 完整 的 项 目 进行 讲解 ， 从 前 期 的 功能 
解 到 一 些 项 目 实战 中 的 其 他 经 验 ， 这 些 对 我 们 的 成 长 应 该 都 是 非常 有 好 处 的 。 此 外 ， 本 书 在 讲解 完整 的 微 博 项 目 实例 的 同时 ， 还 会 按照 功能 把 整个 微 


分 析 、 模 块 设计 ， 到 中 期 的 结构 设计 、 代 码 编写 ， 再 到 


能 点 的 使 


方法 ， 让 大 家 可 以 按照 需 


找到 合适 的 实例 进行 学 习 。 


博 ” 的 问题 。 现 在 我 们 终于 可 以 开始 启动 我 们 


的 话 ， 我 们 也 就 没 必要 开始 这 个 项 目 了 ， 担 忧 的 原 
果 我 们 之 前 已 经 有 过 类 似 的 项 目 经 验 的 话 ， 心 号 


变 得 “心里 更 有 底 一 些 ”。 


为 了 让 开发 过 程 更 加 顺畅 ， 在 应 
方面 来 讲 一 下 需要 准备 的 


开发 之 前 我 们 通 


个 


RH. 


4.2.1 选择 开发 模式 


常 需 


按照 传统 的 “瀑布 型 ”软件 开发 模式 ， 在 “代码 编 


写 ” 之 前 还 必须 有 “需求 分 析 ”、 


就 会 “ 


做 很 多 的 准备 工作 ， 实 际 上 这 些 准备 工作 也 确实 会 对 接 下 来 的 软件 开发 产生 很 


实 也 很 简单 ， 一 句 话 “bs 


Ej] 


后 期 的 系统 优化 ， 让 大 家 不 仅 能 够 学 到 


自己 的 微 博 项 目 了 。 但 是 我 要 提醒 大 家 的 是 ， 在 一 个 项 目 开始 时 ， 我 们 总 会 很 兴奋 ， 有 很 多 的 期 待 ， 也 
因 我 们 可 以 来 分 析 一 下 ， 其 


。 这 其 实 很 正常 ， 当 我 们 开始 接触 一 


在 


有 底 ” 很 多 ， 而 本 书 最 主要 的 目的 之 一 ， 就 是 让 大 家 学 


“概要 设计 ”和 “详细 设计 ” 几 个 步骤 ， 每 个 步骤 我 们 都 必须 严格 执行 并 且 形 成 详细 文档 ， 这 种 进度 显然 会 严 时 


要 的 影响 。 接 下 来 我 们 将 从 开发 模式 、 项 目 策划 和 


完 之 


对 互联 网 应 用 的 项 目 时 能 


H 


A, 


原型 设计 三 


Ei 


胁 到 软件 发 布 的 时 间 期 限 。 为 了 解决 这 个 问题 ， 专 家 们 在 对 实际 项 目 不 断 总 结 的 过 程 中 ， 发 现 了 更 快速 、 更 灵活 的 “敏捷 型 ”的 开发 模式 ， 可 以 说 这 种 新 型 开发 模式 的 出 现 大 大 缩短 了 软件 开发 的 周期 ， 提 


高 了 开发 效率 。 目 前 业界 比较 常见 的 敏捷 型 开发 模式 有 


1.Scrum 模 式 


Scrum 是 一 种 灵活 的 软件 管理 过 程 ， 它 可 以 帮助 你 驾驭 和 迭代、 递增 的 软件 开发 过 程 。Scrum 包 括 了 一 套 完整 的 软件 开发 角色 和 开发 规范 的 骨架 ， 


负责 人 和 开发 团队 三 方 。 其 中 心思 想 是 : 把 软件 开发 按 
排 好 优先 级 ， 然 后 在 冲刺 会 议 上 和 开发 团队 协商 从 而 获 


团 


2.RUP 模 式 


"Scrum" FA "RUP" 等 ， 我 们 来 简要 介绍 一 下 。 


其 主要 角色 有 : Scrum 主 管 (类 似 于 项 目 经 理 ) 、 产 品 
照 一 定 的 时 间 (通常 是 30 天 ) 分 为 多 个 冲刺 周期 ， 每 个 冲刺 期 内 所 需要 实现 的 任务 来 自 产 品 订单 (product backlog) ， 该 订单 由 产品 负责 人 决定 并 
得 冲刺 订单 (sprint backlog) ， 开 发 者 在 周期 剩 下 的 时 间 里 将 按照 冲刺 订单 来 进行 开发 。 


RUP (Rational Unified Process) 统一 软件 


发 过 程 是 面向 


对 象 软件 的 


发 模式 ， 与 Scrum 相 比 它 更 倾向 于 “过 程 ”的 概念 ，RUP 中 的 软件 生命 周期 分 为 初始 阶段 、 细 化 阶段 、 构 造 阶段 和 交付 阶段 ， 


每 个 阶段 结束 时 都 需要 进行 评估 ， 结 果 满意 时 才 可 进入 下 个 阶段 。 实 际 上 ，RUP 也 是 一 种 迭代 式 开发 ， 只 不 过 更 强调 软件 质量 保证 、 团 队 内 部 的 分 工 协作 以 及 可 视 化 模型 的 构建 。 


实际 上 ， 在 软件 项 目的 开发 过 程 中 我 们 通常 会 把 RUP 模 式 和 Scrum 模 式 结合 起 来 使 用 ， 比 如 我 们 通常 会 沿用 Scrum 中 冲刺 周期 的 理论 ， 并 使 用 迭代 式 的 开发 方法 ， 加 快 软件 开发 的 进度 ; 同时 我 们 也 会 
在 冲刺 周期 以 内 使 用 RUP 模 式 中 的 项 目 管理 和 质量 管理 体系 ， 以 及 可 视 化 模型 的 构建 方法 来 增强 软件 开发 的 可 控 性 。 当 然 ， 我 们 还 可 以 更 加 灵活 地 结合 各 种 软件 开发 模式 的 优点 ， 定 制 最 适合 团队 特征 的 开 
发 模式 。 


422 ”了解 项 目 策划 


策划 学 是 近年 来 新 出 现 的 一 门 学 科 ， 是 专门 有 
总 结 起 来 ， 对 未 来 起 到 指导 和 控制 的 作 
计 和 软件 开发 的 重要 依据 。 


FUR. 


此 ， 项 目 策划 是 否 成 功 会 


z 


的 一 门 学 科 。 而 项 目 策划 是 一 门 新 兴 的 策划 学 ， 是 一 种 具有 建设 性 、 逻 辑 性 的 思维 的 过 程 ， 此 过 程 中 最 3 


要 


， 并 最 终 借 以 达成 方案 目标 。 在 软件 项 目的 开发 过 程 中 ， 项 目 策划 是 非常 


直接 影响 到 整个 项 目的 成 败 。 


项 目 策划 有 几 大 特征 : 功利 性 、 社 会 性 、 创 造 性 、 


时 效 性 和 超前 性 ， 下 面 我 们 将 对 这 几 些 特征 逐个 简 和 


ab. 
只 能 


美 ， 也 只 能 是 一 个 失败 的 案例 。 社 会 性 是 指 项 目 策划 
一 个 策划 案 没有 丝毫 创造 性 ， 就 像 一 个 生命 失去 了 灵魂 
云 ， 比 如 我 们 做 一 个 情人 节 的 项 目 策划 ， 但 是 实际 执行 


要 的 ， 比 如 在 Scrum 模 式 中 ， 策 划 方案 是 产品 订 


的 目的 就 是 把 所 有 可 能 影响 决策 的 决定 
以 及 冲刺 订单 的 


要 来 源 ， 是 产品 设 


介绍。 功利 性 指 的 是 实际 经 济 效益 ， 如 果 项 目 策划 的 产 出 低 于 策划 的 投入 ,由 


备 经 


依据 所 处 的 社会 环境 ， 一 个 好 的 策划 除了 


Ln 
一 样 ， 逃 脱 不 了 死亡 的 命运 。 时 效 性 在 项 


目 策划 中 也 是 非常 


一 
TG 


使 策划 的 创意 再 : 


济 价值 之 外 还 需要 具有 社会 价值 ， 脱 离 社会 现实 的 策划 必 将 失败 。 创 造 性 是 所 有 策划 学 的 共性 ， 如 果 


看 要 的 ， 抓 住 时 机 能 让 一 个 策划 达到 最 好 的 效果 ， 但 是 如 果 错过 时 机 的 话 一 切 都 只 是 浮 


时 间 却 排 到 了 4 月 份 ， 


这 岂 有 成 功 之 理 ? 超前 性 其 实 和 时 效 性 有 点 相似 ， 不 过 其 涉及 的 时 间 跨 度 更 大 ， 从 某 种 意义 上 来 讲 策划 想 


本 身 就 是 在 做 一 件 有 预见 性 的 事情 ; 一 个 好 的 策划 必须 
初 目的 ， 实 现 其 最 大 价值 。 


备 超前 性 ， 但 是 也 不 能 盲目 地 追求 超前 


和 场 调 研 ， 准 确 及 时 地 掌握 


达到 预期 的 目标 ， 这 


而 脱离 现实 、 赁 空想 象 。 当 然 ， 如 果 我 们 的 策划 能 满足 以 上 五 个 特征 ， 那 么 就 一 定 可 以 完美 地 达成 策划 的 最 


项 目 策划 一 般 分 为 四 个 步骤 ， 首 先是 前 期 调研 ， 想 要 做 出 正确 的 决策 ， 就 必须 要 通过 
情况 来 制订 具体 的 策划 方案 。 接 下 来 是 项 目 策划 书 的 撰写 工作 ， 一 个 完整 的 项 目 策划 书 通常 包括 序 文 目录 、 策 划 


做 好 沟通 、 监 督 和 评估 工作 ， 保 证 项 目的 顺利 进行 。 


实际 上 ， 本 书 选用 微 博 应 用 来 作为 实战 案例 同样 经 过 细致 的 项 目 策划 ， 通 过 
方案 使 


423 了解 原 型 设计 


和 场 调研 分 析 我 们 找到 了 现在 最 具有 社会 性 和 
Android 和 PHP 这 套 业 界 主流 技术 方案 来 实现 了 一 遍 ; 最后， 如 果 学 完 本 书 之 后 可 以 让 大 家 加 薪 升 职 成 功 的 话 ， 也 算 


时 效 性 的 微 博 应 用 ; 


和 场 的 动向 ， 使 决策 更 有 依据 ， 降 低 策划 风险 。 然 
E 体 、 项 目 预 算 和 项 目 进度 表 等 内 容 。 最 后 就 是 项 目 方案 的 实施 ， 项 目 策划 书 准 备 好 


3 外， 本 书 实例 还 独创 性 地 把 微 博 客 


后 就 是 站 


和 场 分 析 和 细 分 ， 并 针对 现实 
后 ,应 


户 端 到 服务 端的 整套 


有 功利 性 了 。 从 某 种 角度 来 看 ， 这 应 该 算是 一 个 不 错 的 项 


策划 案例 。 


产品 原型 可 以 概括 为 整个 产品 外 观 和 交互 的 框架 设计 ， 简 单 来 说 是 将 产品 各 个 模块 中 的 界面 元 素 和 交互 的 形式 利用 图 形 描述 的 方法 更 加 具体 、 生 动 地 表达 出 来 。 原 型 设计 是 交互 设计 师 与 产品 设计 师 
(PD) 、 产 品 经 理 (PM) 以 及 开发 工程 师 (Developer) 沟通 的 最 好 工具 。 

在 策划 案 制 订 后 ， 交 互 设 计 师 将 根据 策划 案 的 思路 在 原型 设计 工具 上 面 把 产品 的 大 致 外 观 和 基本 交互 以 图 形 描述 的 形式 设计 出 来 ， 这 就 是 原型 图 。 原 型 图 可 分 为 原型 草图 (可 参考 4.4 节 中 内 容 ) 和 产品 
原型 图 两 种 ， 前 者 用 于 原型 设计 的 讨论 和 修改 ， 而 后 者 则 必须 和 产品 外 观 保持 一 致 。 产 品 原型 图 完成 之 后 ， 美 工 就 会 按照 原型 图 把 最 终 Ul 界 面 需要 的 美术 资源 制作 出 来 并 最 终 上 发 过 程 。 

常见 的 原型 设计 工具 有 PPT、Microsoft Visio 以 及 Axure 等 。Microsoft 的 产品 相信 大 家 都 已 经 比较 熟悉 了 ， 这 里 推荐 大 家 可 以 尝试 一 下 Axure 这 款 非 常 强大 的 原型 设计 工具 ， 其 官网 地 址 


是 http://www.axure.com。 


4.3 ”功能 模块 设计 


前 面 我 们 已 经 学 习 了 在 开发 工作 开始 前 我 们 需 


准备 的 对 


情 ， 但 是 这 些 可 能 都 不 是 开发 人 员 需 要 关心 的 


情 。 对 于 开发 者 来 说 ， 可 能 更 关心 “如 何 实现 ”的 问题 


此 在 


体 的 项 目 开发 进程 中 ， 开 发 


; 


者 需要 把 握 “ 功 能 模块 设计 ”和 “应 用 架构 设计 ”这 两 大 关键 步骤 ， 关 于 这 两 个 步骤 的 内 容 ， 我 们 将 在 本 节 和 4.5 节 中 分 别 给 大 家 做 详细 介绍 。 


一 般 来 说， 功能 模块 设计 需要 根据 详细 的 策划 案 来 执行 ， 但 是 本 书 实例 为 了 让 大 家 更 容易 接受 ， 在 这 里 我 们 会 用 目前 业内 公认 做 得 最 成 功 的 “新 浪 微 博 ” 作 为 样板 来 进行 实例 功能 模块 的 设计 。 当 然 ， 
我 们 需要 明确 的 是 ， 想 要 通过 一 个 实例 把 新 浪 微 博 的 所 有 功能 都 实现 ， 这 显然 是 不 现实 的 ; 因此 ， 我 们 需要 从 中 挑选 出 一 些 比较 “有 看 点 ”的 功能 来 进行 实现 ， 表 4-1 就 是 我 们 分 析 得 来 的 微 博 功能 模块 的 设 
计 表 格 ， 里 面 列 出 了 新 浪 微 博 的 主要 功能 和 本 书 的 微 博 实例 准备 实现 的 部 分 功能 。 


功能 模块 erik ile 。 本 书 实例 
注册 & 登录 
更 换 签名 头像 
发 表 微 博 
发 表 评 论 
微 博 列 表 
关注 & 粉丝 
即时 消息 提醒 
转发 微 博 功能 
AR & 聊天 
其 他 功能 


以 上 我 们 已 经 列 出 了 一 个 典型 的 微 博 应 用 所 需要 实现 的 主要 功能 模块 的 内 容 ， 下 面 我 们 来 分 别 解释 和 分 析 一 下 这 些 模块 ， 一 方面 分 析 和 理解 一 下 微 博 应 用 的 功能 特点 ， 另 一 方面 来 看 看 我 们 应 该 在 后 面 
的 开发 过 程 中 如 何 处 理 。 


dp zy Qm Q a cy Qm QT coc 
eH ef eh dD m oc mt oc om oon 


1. 注 册 & 登录 


注册 和 登录 功能 应 该 可 以 算是 现在 绝 大 部 分 的 互联 网 应 用 的 必 备 功能 模块 了 ， 这 个 部 分 是 整个 应 用 中 比较 基础 的 核心 模块 ， 涉 及 的 服务 端 和 客户 端的 功能 点 比较 多 ， 所 以 我 们 很 有 必要 来 实现 一 下 。 其 
实 ， 在 实现 这 个 功能 模块 的 同时 ， 整 个 项 目的 雏形 也 就 展现 在 我 们 面前 了 。 


2. 更 换 签名 头像 


对 于 现在 大 部 分 的 互联 网 应 用 来 说 ， 签 名 和 头像 是 个 人 信息 中 比较 核心 的 部 分 ， 虽 然 每 个 应 用 可 能 对 于 个 人 信息 的 定位 和 属性 设置 都 各 不 相同 ， 但 是 其 中 签名 和 头像 肯定 是 必 不 可 少 的 ， 当 然 这 也 包括 
我 们 所 说 的 微 博 应 用 。 另 外 ， 头 像 功 能 涉及 图 片 处 理 的 相关 功能 ， 这 部 分 的 内 容 对 应 用 开发 来 说 也 是 非常 需要 注意 的 。 因 此 ， 更 换 签名 头像 的 功能 我 们 需要 重点 实现 。 


3. 发 表 微 博 


既然 是 微 博 系统 ， 发 表 微 博 功能 当然 是 微 博 应 用 的 核心 模块 ， 此 功能 是 微 博 应 用 完整 功能 中 重要 的 一 环 。 因 此 ， 不 必 多 说 ， 该 功能 是 必须 要 实现 的 。 


4 .发 表 评论 


对 于 以 “信息 流 ” 为 中 心 的 微 博 应 用 来 说， 评论 功能 也 是 其 中 必 不 可 少 的 一 大 要 素 ， 评 论 功能 可 以 促进 作者 和 读者 之 间 的 交流 ， 也 可 以 丰富 信息 流 的 内 容 。 此 功能 在 我 们 的 实例 中 也 会 实现 。 


5. 微 博 列表 


微 博 列表 可 以 算得 上 是 整个 微 博 应 用 中 最 核心 的 功能 了 。 从 功能 上 来 看 ， 这 里 是 微 博 的 主页 面 ， 也 是 “信息 流 ” 体 现 最 直接 的 地 方 ， 在 这 里 读者 可 以 不 停 刷 新 并 获取 自己 感 兴趣 的 微 博 ， 此 外 这 里 还 是 
微 博 正文 和 评论 界面 的 入 口 所 在 ， 从 技术 方面 来 说 ， 这 里 也 是 我 们 需要 重点 关注 的 地 方 ， 对 于 服务 端 来 说 这 里 是 访问 量 最 集中 的 模块 ， 对 于 客户 端 来 说 是 用 户 体验 中 最 重要 的 地 方 。 因 此 ， 我 们 在 本 书 实例 
中 会 对 把 这 个 功能 模块 当做 最 为 重要 的 内 容 ， 进 行 详细 而 深入 的 讲解 。 


6. 关 注 & 粉 丝 


关注 和 粉丝 是 微 博 中 比较 有 特色 的 功能 。 首 先 ，“ 关 注 ”是 针对 读者 的 功能 ， 在 微 博 上 我 们 可 以 选择 关注 特定 的 一 部 分 用 户 的 微 博信 息 ， 这 样 就 使 得 信息 更 加 “个 性 化 ”， 也 更 好 地 满足 用 户 的 需求 。 
“粉丝 ”是 针对 于 博 主 〈 即 微 博 作者 ) 的 功能 ， 关 注 某 个 微 博之 后 你 就 成 为 该 博 主 的 “粉丝 ”， 当 粉丝 数 突破 某 一 数量 级 时 ， 博 主 往往 能 获得 很 大 的 成 就 感 。 另 外 ，“ 粉 丝 ”的 叫 法 比较 受 名 人 们 的 欢迎 ， 
他 们 之 间 甚 至 还 会 “ 拼 ” 粉 丝 的 数量 。 对 于 这 么 有 特色 的 功能 ,我 们 在 实例 中 当然 是 要 实现 的 。 


7. 即 时 消息 提醒 


对 于 目前 的 智能 手机 来 说， 接受 即时 消息 (Notification) 是 一 项 比较 有 特色 的 功能 ， 那 么 对 于 微 博 这 个 具有 代表 意义 的 移动 互联 网 应 用 来 说 ， 即 时 消息 也 是 一 项 必 不 可 少 的 功能 ; 另外 ， 对 于 客户 端 来 
说 正好 可 以 通过 这 个 功能 介绍 一 下 service 的 使 用 方法 。 因 此 ， 我 们 需要 在 微 博 实例 中 实现 这 个 功能 。 


8. 转 发 微 博 功能 


转发 也 是 微 博 应 用 中 的 主要 功能 之 一 ， 读 者 可 以 把 感 兴趣 的 微 博 转 发 到 自己 的 圈子 里 面 ， 之 前 我 们 也 分 析 过 这 是 使 得 微 博 具有 “传播 性 ”的 主要 原因 之 一 ， 但 是 这 个 部 分 和 其 他 的 模块 只 是 逻辑 的 不 
同 ， 基 本 的 技术 我 们 已 经 在 其 他 的 部 分 中 介绍 到 了 ， 所 以 本 书 实例 将 不 做 介绍 ， 这 个 功能 会 以 “ 课 后 作业 ”形式 交 给 大 家 来 扩展 操练 。 


9. 私 信 & 聊 天 


私信 和 聊天 功能 是 基于 好 友 关 系 之 上 的 ， 而 本 实例 更 侧重 于 微 博 基本 功能 的 实现 。 另 外 ， 由 于 篇 幅 的 关系 ， 关 于 好 友 关 系 这 个 方面 的 功能 ， 本 书 的 实例 中 没 办 法 覆盖 到 了 。 但 是 ， 如 果 大 家 有 兴趣 的 
话 ， 还 是 可 以 利用 在 实例 其 他 模块 的 实现 过 程 中 所 学 习 到 的 类 似 的 设计 方法 ， 把 这 些 功 能 开发 出 来 。 


10 .其 他 功能 


具备 以 上 这 些 功 能 模块 的 微 博 应 用 已 经 是 一 个 比较 完整 的 微 博 系 统 ， 但 是 我 们 干 万 不 要 忘记 ， 一 个 成 就 的 系统 绝对 不 会 是 一 成 不 变 的 ， 就 拿 新 浪 微 博 来 说 ， 我 们 常常 会 在 上 面 看 到 各 种 新 的 功能 、 新 的 
法 。 话 说 回来 ， 本 书 实例 的 主要 目的 绝 不 只 是 为 了 实现 一 个 微 博 系统 ， 而 是 通过 这 个 微 博 系统 的 开发 过 程 来 帮助 大 家 理解 和 熟悉 如 何 使 用 Android 和 PHP 这 两 个 工具 来 进行 移动 互联 网 应 用 的 开发 。 


到 这 里 ， 我 们 已 经 基本 完成 了 “功能 模块 设计 ”的 主要 工作 ， 分 析 过 了 整个 微 博 应 用 的 主要 功能 模块 ， 也 明确 了 我 们 在 本 书 实例 中 准备 实现 的 部 分 ， 接 下 来 在 4.4 节 中 ， 我 们 一 同 来 考虑 一 下 应 用 界面 的 
大 体 设计 。 


44 ”应 用 界面 设计 


实际 上 在 使 用 敏捷 型 开发 模式 的 项 目 (特别 采用 “RUP” 开 发 模式 的 项 目 ) 中 ， 我 们 经 常 把 功能 模块 设计 和 应 用 界面 设计 结合 起 来 ， 也 就 是 采用 “ 边 想 边 画 ” 的 方式 ， 在 设计 应 用 主要 功能 的 同时 ， 也 
把 主要 的 界面 原型 草图 画 出 来 了 ， 随 着 项 目 功能 的 完整 和 细 化 ， 界 面 原型 也 在 不 断 变 得 清晰 和 完善 ， 从 而 最 终 形成 可 供 指导 应 用 开发 的 完整 界面 原型 。 


Android 应 用 程序 发 展 至 今 已 经 形成 了 具有 自己 特色 的 应 用 外 观 ， 根 据 移动 设备 的 特征 ， 此 类 应 用 的 界面 大 部 分 是 以 简单 清爽 的 风格 为 主 ， 界 面 简洁 但 重点 突出 ， 方 便 用 户 单 手 操作 ， 大 家 可 以 拿 一 些 
比较 常见 的 应 用 ， 比 如 新 浪 微 博 、 手 机 QQ 等 研究 一 下 ， 看 看 是 否 具备 前 面 我 们 所 提 到 的 特征 。 另 外 ， 我 们 通常 会 使 用 一 些 原型 设计 工具 来 制作 应 用 界面 的 原型 ， 比 如 图 4-1 和 图 4-2 就 是 我 们 根据 Android 应 
的 特征 所 设计 的 “登录 界面 和“ 微 博 列表 ”功能 模块 的 原型 草图 。 
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实际 上 ， 根 据 界 面 布 


局 的 特点 ， 


微 博 应 


图 4-2 ” 微 博 列表 原型 草图 


中 的 界面 可 以 粗略 分 为 两 大 类 即 “ 独 立 界面 ”和 “框架 界面 ”， 下 面 我 们 将 以 上 面 两 个 界面 为 例 来 介绍 和 分 析 这 两 类 界面 。 


首先 是 “ 微 博 登录 ”界面 ， 此 界面 比较 简单 ， 和 大 部 分 手机 应 用 的 登录 界面 并 无 区 别 ， 用 户 名 和 密码 的 输入 框 、 记 住 密码 选项 框 再 加 上 一 个 登录 按钮 就 构成 了 此 界面 ， 只 要 是 看 到 这 个 界面 的 人 都 可 以 
明确 知道 该 界面 的 功能 。 此 类 界面 的 外 观 没 有 固定 的 框架 和 模式 ， 在 微 博 应 用 中 也 并 不 多 见 ， 因 此 我 们 可 称 之 为 “独立 界面 ”。 


然后 是 “ 微 博 列 表 ” 界 面 ， 此 界面 是 用 户 登录 之 后 看 到 的 第 一 个 界面 ， 也 是 微 博 应 用 最 主要 的 界面 之 一 ， 另 外 该 界面 也 是 微 博 应 用 中 最 具 代表 性 的 界面 ， 该 界面 具备 了 大 部 分 微 博 界面 的 共同 特点 。 我 
们 可 以 看 到 此 界面 分 为 上 、 中 、 下 三 个 部 分 ， 顶 部 是 微 博 应 用 的 导航 栏 ， 包 含 了 界面 提示 和 退出 按钮 等 〈 某 些 应 用 界面 还 可 能 包含 后 退 按钮 ) ; 中 间 的 列表 就 是 我 们 所 关注 的 微 博 信息 了 ， 这 个 部 分 占据 了 
此 界面 绝 大 部 分 的 内 容 ， 可 以 说 是 应 用 最 核心 的 功能 之 一 ; 下 方 则 是 功能 选项 栏 ， 用 户 需要 打开 其 他 功能 界面 的 话 点 击 对 应 的 按键 即 可 。 此 类 界面 有 固定 的 框架 ， 在 微 博 应 用 中 比较 常见 ， 比 如 用 户 登录 之 
后 的 绝 大 多 数 界面 都 具有 这 些 特 点 ， 所 以 我 们 可 称 之 为 “框架 界面 ”。 


从 前 面 我 们 对 微 博 应 用 界面 设计 的 分 析 和 学 习 ， 我 们 可 以 了 解 到 目前 最 主流 的 移动 互联 网 应 用 界面 的 设计 格局 。 当 然 ， 由 于 本 章 篇 幅 的 限制 ， 我 们 不 可 能 在 本 节 把 整个 应 用 所 有 的 界面 都 给 大 家 介绍 一 
遍 ， 关 于 其 他 功能 模块 的 界面 我 们 会 在 5.3.2 节 中 给 大 家 做 进一步 的 分 析 。 


45 ”应 用 架构 设计 


说 起 “架构 设计 ”似乎 总 会 给 人 留 下 一 种 抽象 的 感觉 ， 其 实 这 是 由 于 我 们 对 架构 设计 没有 足够 的 认识 。 在 项 目 开发 时 常常 忽略 这 个 步骤 ， 甚 至 于 在 对 软件 的 整体 架构 没有 任何 概念 之 前 就 已 经 动手 开发 
了 ， 当 然 产生 这 种 情况 的 客观 原因 常常 是 由 于 项 目 肝 间 的 问题 ， 但 是 我 要 说 的 是 ， 在 项 目 开始 之 前 ， 定 义 一 个 良好 的 架构 其 实 是 非常 有 必要 的 事情 ， 当 项 目 逐 渐 往 下 发 展 时 ， 我 们 就 会 慢 慢 发 现 各 种 “ 尊 
颈 ”， 而 软件 本 身 是 否 有 一 个 良好 的 架构 对 于 解决 这 些 瓶 颈 往往 起 着 至 关 重要 的 作用 。 实 际 上 ， 我 遇 到 的 很 多 项 目 都 是 因为 前 期 没有 建立 一 个 良好 的 架构 ， 以 至 于 在 项 目 后 期 遇 到 瓶颈 时 ， 又 要 对 整个 系统 
进行 重 构 ， 不 仅 浪 费 了 非常 多 的 精力 和 资源 ， 也 大 大 拖 慢 了 项 目 进 度 。 


在 开始 其 他 的 后 续 工 作 之 前 ， 我 们 需要 先 设计 一 下 整个 应 用 各 个 模块 和 组 件 之 间 的 基本 层次 结构 ， 这 里 包括 客户 端 和 服务 端 两 个 部 分 的 内 容 。 下 面 就 是 我 们 初步 定 下 来 的 微 博 实例 应 用 的 整体 架构 图 ， 
我 们 来 简单 分 析 一 下 该 架构 中 的 几 个 要 点 。 


图 4-3 ” 微 博 实 例 应 用 的 整体 架构 图 


首先 ， 从 整体 的 架构 思路 上 看 ， 大 家 可 以 很 清楚 地 看 到 : 左边 的 客户 端 模块 和 右边 的 服务 端 模块 之 间 是 使 用 基于 HTTP 的 文本 JSON 格 式 协 议 来 通信 的 ， 至 于 这 个 协议 应 该 如 何 定义 ， 我 们 将 会 在 下 个 小 
节 中 介绍 到 。 


其 次 ， 对 于 客户 端 来 说 ， 我 们 将 使 用 Android 应 用 框架 中 的 HTTP Client 组 件 从 服务 端的 HTTP API 接 口 接收 数据 ， 然 后 交 由 Android UI 界面 层 来 泻 染 界面 并 最 终 展示 出 来 。 对 于 服务 端 需要 注意 的 是 ， 
在 HTTP API 接 口 和 和 MySQL 数据 库 之 间 还 有 一 个 “API Debug 后 台 ”， 这 个 组 件 是 我 们 用 来 调试 服务 端的 API 接 口 用 的 ， 因 为 在 服务 端 和 客户 端 并 行 开发 的 过 程 中 我 们 不 可 能 使 用 客户 端 来 调试 服务 端的 API 
接口 ， 所 以 这 个 调试 后 台 的 存在 能 大 大 减轻 我 们 在 调试 服务 端 逻 辑 时 的 困难 ， 也 是 本 实例 框架 中 “值得 称道 ”的 一 点 。 


最 后 ， 在 了 解 了 整体 架构 之 后 ， 我 们 就 可 以 理 清 后 面 工作 的 思路 了 ， 接 下 来 我 们 首先 需要 设计 一 下 JSON 协 议 的 具体 内 容 ， 然 后 设计 一 下 数据 库 的 结构 ， 之 后 我 们 就 可 以 正式 开始 服务 端 和 客户 端的 编码 
工作 了 。 


4.6 通信 协议 定 X 


协议 的 设计 是 一 门 艺 术 ， 既 不 能 太 复杂 ， 也 不 能 太 简单 ; 因为 太 复杂 则 效率 低 ， 太 简单 却 不 能 满足 需求 。 我 们 之 所 以 选择 JSON 协 议 作为 微 博通 信 协 议 的 基础 ， 就 是 因为 JSON 协 议 的 简便 特性 ; 当然， 


我 们 还 需要 通过 设计 和 加 工 ， 力 求 把 该 协议 制定 得 更 加 合理 。 


在 介绍 微 博通 信 协 议 的 设计 之 前 ， 我 们 需要 了 解 几 条 比较 常用 的 协议 设计 原则 ， 这 些 原则 和 经 验 不 仅 适 用 于 本 书 的 实例 项 目 ， 在 其 他 的 项 目 中 也 都 可 以 用 到 ， 所 以 希望 大 家 可 以 好 好 思考 并 理解 这 几 个 
原则 的 含义 。 


用 性 。 我 们 在 设计 协议 时 首先 考虑 的 是 通用 性 ， 因 为 如 果 协 议 的 功能 有 缺陷 ， 那 可 是 非常 严重 的 事情 ， 搞 不 好 会 影响 到 整个 系统 。 所 以 在 前 期 设计 时 ， 我 们 尽量 把 情况 考虑 得 全 面 一 点 。 


= 


: 简洁 性 。 在 考虑 通用 性 的 同时 ， 我 们 也 需要 考虑 协议 的 定义 是 否 简洁 。 由 于 我 们 这 里 说 的 都 是 网 络 协议 ， 是 通过 网 络 来 传输 的 ; 因此 协议 越 简洁 ， 就 代表 客户 端 与 服务 端的 交互 越 快速 ， 用 户 体验 也 
就 越 流畅 ， 服 务 器 的 负担 也 越 小 。 


: 统一 编码 。 目 前 绝 大 部 分 的 应 用 都 支持 多 语言 ， 所 以 我 们 必须 要 考虑 通用 的 协议 在 不 同 编码 的 情况 下 所 可 能 出 现 的 兼容 性 的 问题 ， 所 以 一 般 情 况 下 我 们 都 会 使 用 UTF-8 编 码 来 构造 数据 。 


依照 以 上 三 个 原则 ， 再 结合 移动 互联 网 应 用 的 特点 ， 我 们 可 以 初步 设计 出 以 下 JSON 格 式 的 基础 协议 框架 。 


{ 
"code" : "正确 或 错误 代码 号 "， 
"message” "提示 ", 
"result": "返回 内 


首先 ， 以 上 这 个 基础 协议 框架 中 几 个 字段 都 是 字符 型 的 ， 方 便 Android 客 户 端 处 理 。 其 中 code 字 段 主要 用 于 给 客户 端 来 识别 处 理 的 结果 ， 一 般 来 说 会 是 一 串 数字 ， 另 外 我 们 通常 还 会 有 一 张 “代码 
表 ”， 用 于 标识 每 个 返回 代码 的 含义 ;message 字段 比较 简单 ， 主 要 用 于 说 明 返 回 的 结果 ， 一 般 为 字符 串 类 型 ， 客 户 端 经 常会 获取 该 字符 串 并 弹出 来 展示 给 用 户 ; 而 result 字 段 包 含 的 是 返回 的 数据 结果 ， 
比如 我 们 需要 获取 最 新 的 微 博 列表 的 所 有 信息 ， 对 于 result 数 据 有 以 下 几 种 可 能 。 


1. 返 回 单个 对 象 数据 
"result" : { 
"模型 名 " : { key : value , key : value http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... } 


} 


以 上 情况 适用 于 仅 返 回 单个 模型 的 情景 ， 比 如 在 用 户 个 人 信息 界面 ， 我 们 只 需要 获取 单个 用 户 的 个 人 信息 ， 那 么 我 们 就 可 以 使 用 这 种 数据 的 构造 形式 ， 其 中 模型 名 就 是 模型 的 名 称 ， 主 要 是 给 客户 端 解 
析 用 的 。 


2. 返 回 对 象 数组 数据 
"result" : í 
"HAZ list" : [ 
{ key : value , key : value http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... }, 
{ key : value , key : value http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... }, 


http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
] 


以 上 的 数据 格式 适用 于 返回 一 个 模型 列表 的 情景 ， 比 如 在 微 博 列表 界面 中 ， 我 们 需要 读 取 最 新 的 若干 条 微 博 信息 ， 则 可 采用 这 种 数组 形式 的 数据 来 返回 多 个 模型 的 数据 ， 其 中 模型 名 就 是 列表 模型 的 名 


3. 返 回 混合 模式 数据 

"result" : { 

"HALA: http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... }, 
"HAZ list" : ( http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... } 


} 


以 上 情况 适用 于 比较 复杂 的 组 合 型 界面 ， 在 这 种 模式 下 ， 服 务 端 API 可 同时 返回 单个 模型 数据 和 模型 列表 格式 的 数据 ， 这 样 就 大 大 增强 了 协议 的 灵活 性 。 


定义 好 了 协议 的 整体 框架 之 后 ， 我 们 就 可 以 开始 进行 服务 端 部 分 代码 的 设计 了 。 其 实 从 简单 的 思路 来 考虑 ， 服 务 端 所 要 做 的 事情 ， 就 是 把 逻辑 运算 的 结果 按照 协议 制定 好 的 格式 把 数据 展示 给 客户 端 。 


47 数据库 结 构 设计 


数据 库 设 计 是 服务 端 编码 之 前 必须 要 做 的 一 个 工作 ， 从 某 种 程度 来 说 服务 端的 模型 其 实 就 是 数据 库 的 模型 ， 所 以 在 进行 服务 端 程序 开发 之 前 ， 我 们 需要 把 数据 库 模型 先 设计 一 下 。 接 下 来 我 们 就 根据 前 
面 设计 好 的 功能 模块 (参考 4.3 节 ) 来 设计 一 下 服务 端 所 需 的 表 结构 ， 以 下 就 是 我 们 设计 好 的 表 结构 ， 下 面 我 们 来 分 析 一 下 。 需 要 说 明 的 是 ， 因 为 实例 的 服务 端 使 用 的 就 是 PHP+MySQL 的 解决 方案 ， 所 以 这 
里 我 们 默认 使 用 MySQL 的 数据 模型 来 设计 表格 ; 另外， 以 下 的 表格 顺序 是 按照 表 名 进行 排序 的 。 


1. 后 台 用 户 表 : admin 


后 台 用 户 表 存储 的 是 服务 端 后 台 (也 就 是 前 面 提 到 的 “API Debug 后 台 ”) 管理 者 的 信息 。 与 微 博 用 户 表 不 同 ， 大 家 要 注意 区 别 一 下 ， 此 表 的 字段 比较 简单 ， 主 要 就 是 记录 下 管理 者 的 用 户 名 和 密码 
于 登录 服务 端 后 台 。 


表 4-2 admin 表 结构 


字段 类 型 主键 作用 


id int(11) YES 管理 员 ID 
name varchar(100) = 管理 员 用 户 名 
pass varchar(100) m 管理 员 密 码 
uptime timestamp — 更 新 时 间 


2. 微 博信 息 表 : blog 


微 博 信息 表 是 本 实例 中 最 重要 的 表 之 一 ， 用 于 存储 我 们 所 写 的 微 博信 息 。 这 里 需要 注意 的 是 此 表 包 含 一 个 “ 宛 余 字段 (commentcount) ”用 于 存储 每 个 微 博 的 评论 数 ， 当 用 户 发 表 了 针对 某 条 微 博 的 


评论 时 ， 我 们 就 会 让 这 个 字段 加 一 。 增 加 这 种 “ 宛 余 字段 ”是 我 们 在 数据 库 设 计时 经 常 使 


Jj: “尽量 站 在 查询 方 的 角度 ”来 考虑 问题 ， 因 为 对 于 微 博 应 用 来 说 肯定 是 查询 量 大 于 写 入 量 的 。 


表 4-3 blog 表 结构 


的 一 种 方法 ， 这 样 做 的 好 处 是 方便 我 们 查询 ， 这 点 是 显而易见 的 ; 其实， 我 们 在 设计 表 模 型 时 需要 注意 一 个 原 


字段 类 型 主键 作用 
id int(11) YES 微 博 ID 
customerid int(11) 一 用 户 ID 
title varchar(255) 一 微 博 标题 
content varchar(1000) = 微 博 内 容 
commentcount int(11) -一 微 博 评 论 数 ( TTA E ER ) 
uptime timestamp = 微 博 发 表 时 间 
3. 评 论 信息 表 : comment 
评论 信息 表 用 于 保存 用 户 评论 的 信息 ， 此 表 中 blogid 和 customerid 属 于 外 键 ， 分 别 对 应 的 是 该 评论 所 属 的 微 博 和 撰写 该 微 博 的 人 。 
表 4-4 comment 表 结构 
字段 类 型 主键 作用 
id int(11) YES 评论 ID 
blogid int(11) 一 微 博 ID 
customerid int(11) 一 用 户 ID 
content varchar(1000) 一 评论 内 容 
uptime timestamp = 评论 时 间 


4. 微 博 用 户 表 : customer 


微 博 用 户 表 也 是 本 实例 的 核心 表 ， 一 般 涉及 


签名 (sign) 和 用 户头 像 (face) 两 个 字段 以 满足 微 博 系统 的 基本 需求 ; 另外 ， 为 了 提高 


表 4-5 customer 表 结构 


户 表 我 们 都 需要 特别 注意 ， 因 为 现在 的 互联 网 系统 基本 都 是 以 


户 为 中 心 的 。 从 下 面 的 表 结构 中 ， 我 们 可 以 看 到 除了 用 户 名 和 密码 之 外 我 们 还 定义 了 用 户 
户 信息 相关 查询 的 效率 ,我们 还 增加 了 两 个 宛 余 字段 blogcount 和 fanscount 分 别 用 于 存储 用 户 的 博客 数 和 粉丝 


TH 类 型 主键 作用 

id int(11) YES 用 户 ID 
name varchar(100) 一 用 户 名 

pass varchar(100) x 用 户 密码 
sign varchar(100) — 用 户 签 名 
face varchar(100) = 用 户头 像 
blogcount int(11) = 发 表 微 博 数 
fanscount int(11) = 粉丝 数 
uptime timestamp = 更 新 时 间 


5. 用 户 粉丝 表 : customer fans 


户 粉丝 表 是 一 张 “ 关 系 表 ”， 保 存 的 是 


为 1 的 记录 。 


户 ID 和 粉丝 ID 之 间 的 对 应 关系 。 举 个 简单 的 例子 ， 如 果 用 户 A (IDA1) 成 为 用 户 B (ID 为 2) 的 粉丝 ， 那 么 此 时 数据 表 里 就 会 多 一 条 customerid 为 2 而 fansid 


表 4-6 customer fans 表 结构 


字段 类 型 主键 作用 
customerid int(11) = 用 户 ID 
fansid int(11) -一 粉丝 ID 
uptime timestamp = 更 新 时 间 


6. 通 知 信息 表 : notice 


有 新 粉丝 了 ， 那 么 我 们 就 会 给 这 个 用 户 发 一 个 通知 ， 而 这 些 通知 我 们 就 会 存在 这 张 表 里 。 


通知 信息 表 保存 的 是 服务 端 发 送 给 客户 端的 消息 数据 ， 比 如 某 个 


表 4-7 notice 表 结构 


字段 类 型 主键 作用 


id int(11) YES 通知 ID 

customerid int(11) 一 用 户 ID 

fanscount int(11) 一 新 增 粉 丝 数 

message varchar(255) = 通知 内 容 

status tinyint(1) == 通知 状态 (是否 已 读 ) 
uptime timestamp = 更 新 时 间 


在 以 上 这 些 表格 都 设计 好 之 后 ， 接 下 来 就 是 建立 表格 的 过 程 。 针 对 我 们 使 用 的 Xampp 集 成 工具 来 说 ， 可 以 进入 phpMyAdmin 工 具 后 台 并 按照 上 面 的 设计 手动 建立 表格 ， 如 果 你 对 如 何 创建 表格 还 有 疑 
问 请 查看 前 面 3.2.4 节 的 内 容 。 在 表格 创建 完成 后 我 们 就 可 以 开始 后 续 的 “程序 编码 ”工作 了 。 


48 人 小结 


作为 “实战 篇 ”的 起 始 章节 ， 本 章 给 大 家 介绍 了 我 们 将 用 于 实战 的 核心 产品 “ 微 博 实例 ”的 方方面面 ， 让 我 们 对 整个 实例 产品 有 了 整体 性 的 认识 。 另 外 ， 我 们 还 特别 按照 实际 项 目的 操作 模式 ， 带 领 大 
家 一 步 步 地 进入 项 目 开发 的 流程 中 来 。 对 于 我 们 来 说 ， 不 仅 可 以 学 到 项 目 开发 的 实战 经 验 ， 还 可 以 学 到 使 用 “敏捷 型 ”开发 模式 的 实用 技巧 ， 大 家 可 以 回顾 一 下 本 章 每 节 的 内 容 ， 应 该 会 对 实际 的 项 目 开发 
有 一 定 的 帮助 。 


第 5 章 程序 架构 设计 


在 第 4 章 中 我 们 已 经 把 在 进行 微 博 实例 开发 之 前 所 要 做 的 几 项 主要 工作 都 做 好 了 ， 接 下 来 ， 我 们 就 要 开始 进入 到 实例 代码 的 开发 实战 阶段 了 。 由 于 本 书 的 实例 更 接近 于 一 个 完整 的 项 目 ， 整 个 实例 代码 已 
经 形成 自己 独特 的 程序 框架 。 另 外 ， 我 们 后 面 所 要 分 析 实 例 功能 的 逻辑 代码 都 是 建立 在 这 个 程序 框架 基础 之 上 的 ， 所 以 ， 在 分 析 具 体 功能 的 逻辑 代码 之 前 ， 我 们 应 该 先 把 微 博 实例 服务 端 和 客户 端的 程序 的 
核心 框架 搞 清楚 。 本 章 将 主要 围绕 微 博 实例 的 服务 端 和 客户 端的 核心 程序 架构 给 大 家 做 一 下 详细 介绍 。 


也 许 有 些 读者 可 能 会 等 不 及 跳 过 本 章 ， 直 接 进 入 后 面 的 实例 代码 分 析 章 节 ， 但 是 我 在 这 里 还 是 要 强调 一 下 本 章 内 容 的 重要 性 。 因 为 ， 学 好 本 章 的 内 容 会 对 更 好 地 理解 具体 功能 的 逻辑 代码 起 至 关 重要 的 
作用 ; 另外 ， 通 过 本 章 我 们 还 可 以 学 到 非常 珍贵 的 关于 如 何 对 程序 逻辑 代码 进行 “封装 ”的 技巧 和 经 验 ， 相 信 这 些 知 识 也 会 对 大 家 日 后 更 深入 地 学 习 计算 机 语言 的 编程 大 有 神 益 。 


5.1 ”服务 端 程序 架构 设计 


首先 ， 我 们 来 观察 一 下 服务 端 程序 的 基础 架构 图 (如 图 5-1 所 示 ) ， 我 们 从 以 下 这 张 图 中 可 以 看 到 服务 端的 程序 框架 的 层次 结构 分 为 四 个 部 分 ， 下 面 我 们 来 分 别 介绍 一 下 。 


App’s Library 


Hush Framework 


Zend Framework 


图 5-1 服务 端 程 序 框架 
1.App MVC 层 


首先 ， 我 们 习惯 于 把 应 用 程序 (Application) 简称 为 App。 然 后 我 们 需要 知道 ， 由 于 本 实例 的 代码 是 遵循 MVC 三 层 结构 的 设计 思路 来 设计 的 (关于 MVC 三 层 结构 的 概念 和 内 容 我 们 会 在 下 面 的 5.1.3 节 
中 做 些 探讨 ) ， 所 以 这 里 将 本 层 称 为 “App MVC" E; 实际 上 ， 本 层 是 整个 服务 端 程 序 架构 的 最 上 层 ， 也 就 是 微 博 实例 程序 具体 功能 的 逻辑 代码 层 ， 关 于 其 使 用 方法 以 及 代码 分 析 我 们 将 会 在 第 6 章 中 详细 
讲解 。 


2.App 的 Library 层 


顾名思义 ， 本 层 是 实例 应 用 程序 (App) 的 类 库 (Library) 层 ， 前 面 提 到 的 MVC 逻 辑 代 码 都 是 建立 在 这 个 层次 之 上 的 。 实 际 上 ， 在 一 个 比较 成 熟 的 项 目 中 ， 我 们 常常 会 把 平时 比较 常用 的 代码 和 功能 按 
照 类 (class) 或 者 方法 (function) 的 方式 “封装 ”到 项 目的 类 库 层 中 ， 这 样 做 主要 有 两 个 好 处 : 其 一 是 可 以 简化 开发 ， 当 我 们 需要 使 用 某 些 重 复 性 的 逻辑 代码 时 ， 只 需 在 相应 的 位 置 调用 对 应 的 类 和 方法 
即 可 ， 这 样 不 仅 可 以 大 大 减轻 代码 编写 工作 的 负担 ， 也 可 以 让 整个 程序 更 利于 阅读 ; 其 二 是 可 以 加 强 我 们 对 某 些 重点 逻辑 的 控制 ， 做 过 项 目的 人 可 能 对 这 一 点 体会 得 比较 深 。 比 如 在 应 用 中 很 多 的 地 方 需要 
验证 用 户 是 否 登录 ， 比 较 好 的 做 法 就 是 把 这 个 逻辑 提取 出 来 写 入 一 个 isLogin () 方法 里 ， 在 需要 用 到 的 地 方 调用 即 可 ， 这 样 一 来 ， 以 后 登录 验证 的 方式 发 生 改 变 时 ， 我 们 只 需 修 改 isLogin () 方法 的 逻辑 就 
可 以 了 ， 而 无 需 修改 每 个 验证 的 地 方 。 


3.Hush Framework 层 


首先 ， 我 们 要 知道 微 博 实例 的 服务 端 是 在 Hush Framework 框 架 的 基础 上 开发 出 来 的 ， 当 然 包 括 实例 应 用 程序 的 类 库 层 (App' s Library) ; 另外 ， 关 于 Hush Framework 的 特点 和 基本 用 法 我 们 在 3.6 
节 中 已 经 给 大 家 做 了 比较 详细 的 介绍 ， 有 疑问 的 朋友 可 以 回顾 一 下 。 


另外 ， 这 里 我 们 需要 搞 清 楚 的 是 Hush Framework 和 App 类 库 (App' s Library) 层 的 区 别 ，App 类 库 层 的 代码 逻辑 和 微 博 实例 的 功能 模块 结合 得 比较 紧密 ， 而 Hush Framework 层 则 是 和 应 用 逻辑 无 
关 的 ， 也 就 是 说 这 里 所 说 的 App 类 库 层 只 能 被 本 书 的 微 博 实例 所 使 用 ， 而 我 们 却 可 以 在 Hush Framework 基 础 之 上 构建 出 其 他 不 同 的 应 用 。 


4.Zend Framework 框 架 和 Smarty 模 板 引擎 


在 第 3 章 我 们 同样 给 大 家 介绍 了 Zend Framework 框 架 和 Smarty 模 板 引擎 的 概念 和 用 法 ，Hush Framework 框 架 正 是 建立 在 这 个 基础 层次 之 上 的 ， 如 果 你 对 这 个 部 分 还 有 疑问 请 返回 前 面 的 章节 看 一 
下 。 当 然 由 于 本 书 篇 幅 的 原因 ， 想 要 只 和 赁 本 书 就 把 这 两 个 框架 完全 掌握 是 不 大 现实 的 事情 ， 但 是 我 希望 能 通过 本 书 的 讲解 让 大 家 懂得 应 该 如 何 正确 地 、 灵 活 地 使 用 这 些 常 用 的 PHP 框 架 和 模板 组 件 ， 然 后 在 
平时 使 用 的 过 程 中 主动 去 学 习 并 熟练 起 来 ， 进 而 掌握 这 些 “实战 工具 ”并 为 己 所 用 ， 这 是 我 最 希望 能 够 达到 的 效果 。 


在 本 节 中 ， 大 家 需要 理解 的 是 本 实例 的 代码 框架 的 层次 结构 ， 对 于 大 部 分 的 实际 项 目 来 说 ， 建 立 起 这 样 一 个 合理 的 代码 框架 层次 是 一 件 非常 重要 的 事情 ， 我 们 在 学 习 PHP 编 程 的 同时 也 需要 注意 培养 自 
己 善 于 分 层 归 纳 的 能 力 ， 这 个 对 大 家 以 后 能 否 把 握 更 大 型 或 者 更 复杂 的 项 目 都 会 有 很 大 的 益处 。 


5.1.1 ”基础 框架 设计 


对 于 一 般 的 移动 互联 网 应 用 来 说 ， 服 务 端 最 主要 的 作用 在 于 提供 一 系列 的 API 给 客户 端 来 调用 ， 在 第 4 章 中 我 们 已 经 把 本 书 微 博 实例 的 “总 体 架构 ”、“ 消 息 协议 ”以 及 “数据库 结 构 ” 几 项 工作 都 完成 
了 ， 接 下 来 我 们 进入 基础 框架 代码 设计 的 阶段 。 由 于 基础 框架 设计 是 服务 端 开发 的 基础 知识 ， 所 以 本 节 的 内 容 是 非常 重要 的 ， 我 希望 大 家 能 好 好 理解 和 消化 本 节 的 内 容 ， 把 服务 端 基础 框架 的 思路 看 懂 学 
会 ， 为 我 们 后 面 剖析 具体 功能 的 代码 设计 打 好 基础 。 


导入 本 书 光盘 中 的 微 博 实例 服务 端 代码 之 


c (具体 的 导入 方法 与 步骤 可 参考 附录 B 的 内 容 ) ， 我 们 可 以 在 Eclipse 的 项 


浏览 界面 中 看 到 app-demos-server 项 目 。 接 下 来 ， 我 们 就 可 以 打开 该 目录 ， 观 察 
服务 端 实例 代码 的 基本 目录 结构 ， 目 录 说 明 5-1 所 示 的 就 是 主要 目录 的 作用 ， 大 家 可 以 结合 实例 代码 进行 比 对 学 习 。 

目录 说 明 5-1 

app-demos-server 

- bin : 可 执行 脚本 入 口 

- dat : 数据 目录 

- doc : 文档 目录 

|- install : 服务 器 配置 文件 
- etc : 配置 文件 目录 
- lib : 逻辑 类 库 
|- Demos 
|- App : 应 用 逻辑 (Controller) 类 库 
|- cii : 后 台 脚 本 逻辑 类 库 
|- Dao : 数据 库 操作 类 
|- Util : 工具 类 库 
- tpl 
|- server : 接口 站 点 模板 (View) 
|- website : 前 台 站 点 模板 (View) 
人 : 接口 站 点 根 目 录 (DocumentRoot) 
|- website : 网 页 站 点 根 目 录 (DocumentRoot) 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 

其 实 ， 如 果 把 以 上 的 基础 代码 结构 和 之 前 给 大 家 介绍 的 Hush Framework 实 例 应 用 的 目录 结构 做 一 下 对 比 ， 我 们 可 以 看 到 这 两 个 应 用 的 结构 是 非常 相似 的 ， 这 是 因为 我 们 的 微 博 应 用 实际 上 就 是 一 个 
Hush Framework 的 实例 应 用 。 唯 一 稍 有 不 同 的 是 Hush Framework 的 实例 中 有 两 个 站 点 根 目录 ， 分 别 是 前 台 站 点 目录 (frontend) 和 后 台 站 点 目录 (backend) ， 因 为 目前 绝 大 部 分 的 互联 网 应 用 都 是 
B/S 类 型 的 ， 是 分 前 后 台 的， 前台 站 点 负责 内 容 展示 和 供用 户 操作 ， 后 台 站 点 则 负责 管理 整个 应 用 的 各 种 配置 等 ; 然而 本 书 微 博 应 用 却 不 同 于 前 者 ， 属 于 C/S 类 型 的 应 用 ， 服 务 端的 API 主 要 是 提供 给 客户 端 
调用 的 ， 因 此 本 应 用 的 服务 端 分 为 接口 站 点 (server) 和 网 页 站 点 (website) 两 个 目录 ，Apache 服 务 器 的 站 点 根 目录 就 设置 在 此 。 


小 贴 士 : B/S 是 Browser/Servet 的 缩写 ， 一 般 指 运行 在 浏览 器 端的 应 用 ; 而 C/S 是 Client/Servet 的 缩写 ， 一 般 指 带 客户 端的 程序 。 


要 搞 清楚 一 个 程序 的 基础 框架 是 如 何 
都 是 使 
照 前 面 的 
1 所 示 。 


构成 的 ， 最 好 的 方式 莫 过 于 把 整个 项 目的 代码 从 头 到 尾 阅读 一 遍 ， 特 别 对 于 PHP 程 序 来 说 ， 由 于 本 身 并 没有 什么 生命 周期 的 概念 ， 所 有 的 MVC 
PHP 原 生 代码 写 出 来 的 ， 如 果 不 理解 透彻 丸 怕 在 后 面 使 用 时 会 因为 不 知 其 所 以 然而 发 生 各 种 错误 。 我 们 已 经 知道 了 项 目的 目录 结构 ， 那 么 应 该 从 何 入 手 呢 ? 首先 我 们 应 该 


目录 结构 介绍 我 们 已 经 知道 接口 站 点 的 站 点 根 目录 在 www/server 目 录 下 ， 打 开 该 目录 我 们 就 可 以 看 到 默认 的 首页 文件 ndex.php， 而 这 个 PHP 程 序 也 就 是 整个 站 点 的 入 


层次 封装 和 类 库 加 载 
PERSE MERIAL, H 
DESERT CASS - 


; 3E 


代码 清单 5-1 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 初始 化 应 用 类 

Sapp = new Demos App(); 

// 配置 应 用 重要 参数 


Sapp->setErrorPage ( 
-»addMapFile( 


1/404. php!) 


MAP INI FILE) 


-»addAppDir( LIB PATH SERVER) 


->addAppDir ( 


LIB PATH WEBSITE); 


// 将 所 有 的 调试 信息 和 错误 打印 关闭 ， 建 议 在 正式 环境 关闭 

$app->setDebug (true); 

// 设置 控制 器 类 (Controller) 的 类 名 后 缓 

Sapp->run (array ( 
'defaultClassSuffix' => 'Server' 


); 


我 们 可 以 看 到 在 上 面 的 程序 中 ， 所 有 代码 逻辑 的 最 前 面 初始 化 了 一 个 Demos_ App 对 象 ， 此 对 象 就 是 整个 应 
以 及 两 个 控制 器 类 库 的 路 径 ， 这 些 都 是 应 用 程序 的 必要 配置 。 而 这 些 配置 的 常量 值 ， 都 被 配置 在 应 


程序 的 基 类 。 然 后 ， 代 码 给 这 个 对 象 配置 了 404 页 面 、 路 径 映 射 文件 (用 于 设 定 URL 路 由 ) 
框架 的 配置 文件 (etc/app.config.php) 中 ， 其 中 的 主要 配置 已 经 摘录 到 代码 清单 5-2 中 。 


H 


代码 清单 5-2 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
define(' HOST SERVER', 'http://127.0.0.1:8001'); 

define(' HOST WEBSITE', 'http://127.0.0.1:8002'); 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
define(' MAP INI FILE', realpath( ETC . '/app.mapping.ini')); n 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
define(' LIB PATH SERVER', realpath( LIB DIR . ' /Demos/App/Server') E 

define(' LIB PATH WEBSITE', realpath( LIB DIR . '/Demos/App/Website')); 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


从 上 述 代 码 中 ， 我 们 可 以 看 到 应 用 框架 的 配置 文件 中 不 仅 设置 了 Hush_App 对 象 所 需 的 几 个 重要 参数 ， 比 如 API 控 制 器 类 库 地 址 “_LIB_PATH_SERVER” 和 网 页 控制 器 类 库 地 
址 ”LIB_PATH_WEBSITE”， 其 中 前 者 就 是 我 们 所 有 的 AP 逻辑 所 对 应 的 控制 器 类 文件 存放 的 目录 (对 应 lib/Demos/App/Server) ， 我 们 在 第 6 章 中 将 重点 介绍 其 中 的 类 库 文 件 。 此 外 ， 配 置 文件 还 设置 
了 API 接 口 站 点 地 址 “_HOST SERVER” 和 网 页 接口 站 点 的 地 址 " HOST WEBSITE”， 这 两 个 设置 必须 和 HTTP 服 务 器 所 设置 的 站 点 地 址 一 致 。 实 际 上 ， 此 处 的 站 点 设置 和 URL 路 径 组 合 起 来 才 是 API 接 


的 完整 地 址 ， 也 就 是 我 们 可 以 在 浏览 器 中 访问 到 的 URL 地 址 。 


口 


回 到 入 口 


文件 的 逻辑 ( 见 代码 清单 5-1) ， 当 入 口 程序 中 的 Demos_App 对 象 设置 完毕 之 后 ， 程 序 就 会 调用 run 方 法 来 运行 整个 页 面 了 。 在 本 框架 中 ， 我 们 可 以 通过 传 入 参数 给 run 方 法 指定 一 些 特 殊 的 需 
求 ， 比 如 这 里 我 们 就 设置 了 defaultClassSuffix 参 数 ， 指 定 本 项 目 控制 器 类 的 后 缀 为 Server。 需 要 提示 的 一 点 是 ， 从 之 前 对 Hush Framework 框 架 的 介绍 中 我 们 了 解 到 该 框架 默认 的 控制 器 类 的 后 缀 名 其 实 是 
Page， 比 如 第 3 章 中 使 用 的 框架 实例 “登录 页 面 ” 中 的 控制 器 类 名 就 叫 AuthPage， 而 由 于 我 们 的 实例 更 趋向 于 接口 API 的 概念 ， 所 以 这 里 才 把 控制 器 后 缀 命名 为 Server。 


提 到 的 路 径 映 


H 


最 后 ，run 方 法 把 URL 的 路 径 映 射 到 对 应 的 控制 器 类 来 处 理 。 为 了 便于 大 家 理解 ， 这 里 以 “登录 接口 ”为 例 给 大 家 讲解 一 下 。 比 如 “登录 接口 ”的 URL 路 径 为 “/index/login”， 通 过 前 
射 之 后 ， 就 会 被 映射 到 lib/Demos/App/Server/IndexServer.php 文 件 对 应 的 IndexServer 类 中 的 loginAction 方 法 来 处 理 。 对 于 客户 端 来 说 ， 会 传递 参数 到 URL 地 址 “http://127.0.0.1: 
8001/index/login” 来 访问 登录 接口 ， 我 们 也 可 以 打开 浏览 器 查看 该 接口 的 输出 信息 ， 返 回 结 果 如 代码 清单 5-3 所 示 ， 信 息 是 以 JSON 数 据 格 式 组 成 的 ;关于 此 协议 的 设计 和 定义 我 们 可 以 参考 4.5 节 的 内 容 。 
这 里 我 们 可 以 看 到 此 时 接口 返回 的 是 “登录 失败 ” (Login failed) 的 结果 ( 见 代码 清单 5-3) ， 这 是 由 于 我 们 传递 的 接口 参数 有 问题 。 


代码 清单 ”5-3 


"code":"10003", 
"message":"Login failed", 
"result": 
{ 
"Customer": 
{ 
"sid":"6cmutllfb9tar3c3kp66c6prrmhrh2u0" 
} 


至 此 ， 我 们 介绍 了 基础 框架 中 最 核心 的 关于 路 径 映射 部 分 的 思路 ， 从 入 口 程序 文件 ndex.php 开 始 ， 到 “登录 接口 ”如 何 把 最 终 的 返回 信息 打印 出 来 ， 大 家 现在 应 该 已 经 对 这 个 过 程 比较 了 解 了 。 不 过 
前 面 分 析 的 是 一 般 的 路 径 映 射 过 程 ， 其 实在 本 实例 还 使 用 了 Hush Framework 的 路 径 映射 配置 文件 (etc/app.mapping.ini) 来 处 理 路 径 逻 辑 ， 相 关 配 置 见 代码 清单 5-4。 文 件 中 的 配置 比较 好 理解 ， 格 式 有 
点 类 似 于 Apache 的 重 写 规则 ， 每 一 条 规则 都 可 以 处 理 一 个 或 者 一 组 URL 路 径 。 比 如 下 面 的 第 一 条 规则 是 把 默认 路 径 “/” 对 应 的 逻辑 设置 到 Debugserver 类 的 indexAction 方 法 里 ; 而 第 二 条 规则 是 
把 /debug/” 路 径 下 面 的 所 有 路 径 映射 到 DebugServer 对 应 的 Action 方 法 里 ， 至 于 为 何如 此 设置 ， 我 们 会 在 5.1.2 节 中 给 大 家 说 明 原 因 。 


代码 清单 ”5-4 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
= DebugServer: :indexAction T 

/debug/* = DebugServer::* 

http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


既然 已 经 讲 到 这 里 ， 那 我 们 就 来 顺便 讲解 一 下 DebugServer 类 中 的 部 分 程序 逻辑 吧 。 该 类 文件 位 于 lib/Demos/App/Server/DebugServer.php， 下 面 给 大 家 重点 讲解 前 面 配 置 文件 中 提 到 的 
indexAction 方 法 ， 方 法 逻辑 见 代 码 清单 5-5。 


代码 清单 5-5 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
class DebugServer extends Demos_App Server 
{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function indexAction () 
{ 
Sthis-> printHome () ; 
echo "&gt; <a href='/debug/apiHome'>Debug Console</a><br/>\n"; 
echo "&gt; <a href='/doc/api/index.html'>Api Document</a><br/>\n"; 
echo "&gt; <a href='/doc/lib/index.html'>Lib Document</a><br/>\n"; 
J 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
protected function _printHome () 
{ 
echo "<table class-'tbmin' cellpadding=0 cellspacing=0>\n"; 
echo "<tr><td>VISITOR IP</td><td>:</td><td>" . $ SERVER['REMOTE ADDR'] . "</td></tr>\n"; 
echo "</table>\n"; 
echo "<hr/>\n"; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


其 实 ，indexAction 方 法 的 逻辑 很 简单 ， 就 是 打印 出 一 些 HTML 的 模板 代码 用 于 展示 页 面 ， 执 行 效果 如 图 5-2 所 示 ， 其 实 该 页 面 也 就 是 打开 服务 端 API 站 点 的 首页 。 另 外 ， 由 于 本 实例 主要 是 提供 API 接 
给 客户 端 调 用 的 ， 仅 有 的 几 个 网 页 界面 就 是 “后 台 调 试 界面 ”中 的 一 些 调试 页 面 ， 所 以 在 本 微 博 服 务 端 实例 中 我 们 并 没有 使 用 smarty 模 板 。 


127.0.0.1:80 


Demos Debug Server - v1.0 


VISITOR IP : 127.0.0.1 


> Debug Console 


> Api Document 
> Lib Document 


图 5-2 ”服务 端 入 口 界面 


当然 在 基础 框架 设计 所 需要 掌握 的 知识 点 中 ， 除 了 前 面 我 们 重点 分 析 的 目录 框架 设计 和 路 径 映射 思路 之 外 ， 还 有 几 个 部 分 也 是 需要 大 家 重点 去 了 解 的 ， 也 包括 下 面 我 们 要 给 大 家 介绍 的 “调试 框 
架 ” 和 “核心 类 库 ” 两 个 部 分 ， 前 者 是 用 于 辅助 API 接 口 开 发 的 一 个 框架 特色 ， 后 者 则 是 用 于 具体 开发 的 基础 内 容 ， 接 下 来 给 大 家 介绍 一 下 这 两 部 分 的 内 容 ， 让 大 家 能 进一步 了 解 整个 服务 端 程序 的 总 体 架 
构 。 


5.1.2 ”调试 框架 设计 


大 家 应 该 已 经 知道 微 博 服务 端的 应 用 程序 是 以 API 接 口 为 主 的 ， 并 不 像 传统 的 互联 网 应 用 那样 由 页 面 组 成 ， 可 以 直接 看 到 程序 的 最 终 运行 结果 来 进行 调整 ， 因 此 我 们 在 做 项 目的 过 程 中 常常 会 感觉 调试 起 
来 非常 困难 ， 也 正 是 由 于 这 个 原因 我 们 才 特 别 需 要 一 个 带 界面 可 以 操控 的 “调试 后 台 ” 来 改善 这 种 情况 ， 这 也 可 以 算是 本 应 用 框架 的 一 个 亮点 所 在 ， 下 面 我 们 先 来 熟悉 一 下 这 个 调试 后 台 的 总 体 框架 的 基本 
思路 和 用 法 ， 以 下 是 对 “调试 后 台 ” 中 最 重要 的 几 个 页 面 的 介绍 。 


1. 后 台 首页 


打开 网 址 “http://127.0.0.1: 8001” 我 们 就 能 看 到 调试 后 台 的 首页 ， 页 面 效 果 如 图 5-2 所 示 ， 在 前 面 的 章节 中 我 们 已 经 介绍 了 这 个 页 面 是 如 何 展示 出 来 的 ， 而 此 页 就 是 调试 后 台 的 入 口 。 这 样 的 设计 主 
要 是 为 了 方便 接口 API 的 调试 工作 。 


2. 登 录 页 面 


点 击 “后 台 首 页 ”中 的 “Debug Console” 链 接 就 可 以 进入 登录 页 面 ， 此 页 面 很 简单 就 不 多 说 了 ， 后 台 是 需要 输入 管理 用 的 用 户 名 和 密码 才能 进入 的 ， 因 为 虽说 只 是 一 个 调试 后 台 ， 但 是 安全 性 是 我 们 
设计 过 程 中 不 得 不 考虑 的 一 个 因素 ， 因 此 还 是 需要 登录 验证 的 ， 我 们 默认 的 用 户 名 和 密码 都 是 admin， 大 家 输入 后 就 可 以 进入 调试 后 台 的 主 界面 了 。 


后 台 主 界面 的 布局 比较 简单 (如 图 


5-3 所 示 ) ， 页 面 上 方 的 菜单 链接 就 是 两 大 主要 功能 模块 的 入 口 ， 一 是 “实时 接口 测试 (Api Test)" ， 里 面 是 我 们 


绍 一 下 此 工具 的 用 法 ; 而 “接口 访问 统计 (Api Stat) ” 则 是 对 所 有 API 接 口 的 访问 统计 ， 这 里 暂时 不 做 介绍 。 


€)? { j 127.0.0. 1:8001/debug/ apiHome?si d=k3j sgft9j549j0madu3k21phk] 
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Home | Api Test | Àpi Stat | Logout 


> Api Test: 实时 接口 测试 
> Api Stat : 接口 访问 统计 


Welcome admin 


4 测试 接口 列表 


测试 接口 列表 页 面 如 图 5-4 所 示 ， 此 页 面 就 是 调试 后 台 框架 的 核心 所 在 ， 也 是 我 们 后 面 最 常 使 
类 ， 包 括 接 口 的 说 明和 地 址 信息 ， 点 击 右边 的 “测试 ”链接 则 可 进入 具体 的 接口 测试 页 面 了 。 


图 5-3 后 台 主 界面 


€^ | 上 127 n n 1:ann1/asbugfapilist?=idz8btlejienñzS=s997, Q) + 


用 的 工具 之 一 ， 这 里 我 们 可 以 看 到 所 有 接口 的 列表 ， 我 们 可 以 看 到 所 有 的 API 接 


于 调试 API 接 口 的 主要 工具 ， 后 面 我 们 会 重点 介 


口 都 已 按照 控制 器 类 名 归 


Demos Debug Server - v1.0 


Home | ápi Test | Api Stat | Logout 


BlogServer 
blogListAction 


blogViewAction 


blogCreateAction 


CommentServer 


commentListAction 


commentCreateAction 


CustomerServer 


customerListAction 
customerViewdction 
customerEditAction 


customerCreateAction 


fansAddAction 


fansDelAction 


5. 接 口 测试 工具 


为 了 说 明 整 个 调试 过 程 ， 我 们 挑选 “ 微 博 列表 接口 ”作为 例子 ， 点 击 右边 的 “测试 ”链接 来 进入 “接口 测试 工具 ”页 面 ， 如 图 
(action) 、 测 试 参数 (Test Data) 、 请 求 方法 (method) 都 准备 好 了 ， 点 击 “ 提 交 测 试 ”按钮 就 可 以 进行 对 “ 微 博 列表 接 
面 看 到 请 求 的 结果 。 当 然 此 时 访问 ， 我 们 可 以 看 到 结果 显示 的 是 “Please login firstly" ， 也 就 是 提示 我 们 要 获取 微 博信 息 列表 是 必须 先 登 录 的 。 


微 博 列表 接口 
查看 微 博 正文 接口 
RH EA 


评论 列表 接口 
发 表 评 论 接口 


用 户 列表 接口 


查看 用 户 信息 接口 
更 新 用 户 信息 接口 
新 建 用 户 接 口 
Wein 
圳 除 精 丝 接口 


/blog/blogList 
/blog/blogView 
/blog/blogCreate 


/conment /commentList 


/conment /commentCreate 


/custoner/customerList 


/custoner/cuztomerView 


/customcr/customcrEdit 


/customer/customerCreate 


| /customer/fansAdd 


/customer/fansDel 


测试 接口 列表 界面 


= 


E 
BE 


E 


BE [BE [Bb OBL mE 


5-5 所 示 ， 我 们 可 以 看 到 这 个 界面 已 经 帮 有 我 们 把 微 博 列 表 接 口 的 接口 地 址 
口 ” 的 模拟 访问 测试 了 ， 我 们 可 以 在 测试 结果 (Test Result) 右面 的 文本 框 里 


< > | [7] 127. 0. 0, 1:8001 / debug/ap: Tast? servi cetlem e=BlogS erverdacts ont (Q ^ ^ v 图- Bx 
`—— 
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Home | Api Test | Api Stat | Logout 


BlogServer > blogListAction 
title 横 博 列表 接口 
action | fblog/blogList?sid-Bbilejicnüsbs29Tqlo8enpd9TT161op& 
KEY : [typerd VAIUE :0 — — (6 全 部 , 1. B 
Test Data B. 2: AE) 
KEY : [paged | VALUE : D (INT) 


method 


Test Submit 


"code" : "10001", 
"message °: Please login firstly. ”, 
MM" 


result”: 


Test Result 


图 5-5 ” 微 博 列表 接口 测试 界面 


所 以 我 们 可 以 尝试 着 返回 “接口 测试 列表 ”页 面 找到 “用 户 登 录 接 口 ”， 同 样 点 击 右 侧 的 “测试 ”链接 ， 进 入 用 户 登 录 接口 的 测试 页 面 ， 然 后 填写 默认 的 用 户 名 和 密码 (系统 默认 均 为 james) ， 并 点 
击 “ 提 交 测 试 ”按钮 (如 图 5-6 所 示 ) ， 当 看 到 返回 为 “Login ok” 也 就 是 登录 成 功 的 提示 以 及 用 户 信息 的 JSON 数 组 之 后 ， 再 返回 之 前 的 “ 微 博 列表 接口 ”进行 测试 。 


e: 127.0.0.1:8001 /de&bug/anl Test? serviceName- Indexserver&actionName -1o ginAc o 
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Home | Api Test | Api Stat | Logout 


IndexServer > loginAction 
title Rr RE] 
action Andex/| logi n? sid -us4dr706enb28i2 ri2421420c19c ki2c& 


KEY : [nane VALUE : janss (STRING) 


KEY: [pass VALUE : janes (STRING) 


Test Data 


method | post 
Test Submit eh, 


*code":"10000", 

"message":"Login ok", 

"result": 

"Customer":[ 

"id':1, 
*"name":*james", 
"sign":"Happying", 
*face’:"0", 
*blogcount":2, 
"fanscount":0, 
"uptime":2011-12-29 16:08:04", 
"sid":"usddr706enb28i2ri242i420c19clá2c" 


Test Result 


图 5-6 用户 登录 接口 测试 界面 


从 下 图 5-7 中 我 们 可 以 看 到 ， 再 次 访问 “ 微 博 列表 接口 ”就 可 以 看 到 该 用 户 所 写 的 所 有 微 博 的 列表 了 。 实 际 上 ， 客 户 端 的 访问 行为 和 我 们 之 前 的 操作 基本 上 是 一 样 的 ， 这 也 就 是 为 什么 我 们 使 用 本 工具 就 
可 以 模拟 所 有 客户 端 API 接 口 访问 的 原因 。 


L27.0.0.1:500Ldshbhuz api Tast? zarri cadano Bl og5 orvor&acti ont @ 
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om | Api Test | Api Stat | Logout 


BlogServer > blogListAction 


title 
action 


Test Data 


method 


Test Submit 


Test Result 


以 上 就 是 我 们 应 用 中 所 特有 的 “调试 框架 ”的 基本 用 法 说 明 ， 如 果 你 想 知道 此 框架 是 如 何 实现 的 ， 以 及 其 中 


Pata RED 
/blog/blogList?sid=8bt leji en®eS5e997ql agenpdasrT161ore. 


KEY : typeld VALUE : [o 
E. 2: XE 


BEY : pageId VALUE ; [o 


(0. $88, 1. Bl 


(INT) 


get 


"code" : "10000", 
"message": Get blog list ok", 
“result”; f 

eec E 


*id":5, 


"£nce" "http: \/\/192. 168. 1. $:8002\/faces\ default 


V/face_d. png”, 


“content”: "<b>james<\/b> : test blog 1”, 
“comment”: \uSbcd \uSbball)”, 
“uptime”:"2012-01-14 21:51:54" 


“id” 34, 


“face”: “http: V/A/192. 168. 1. 3:8002\/faces\/default 


H5- 微 博 列表 接口 测试 界面 


点 代码 逻辑 的 细节 ， 我 们 将 会 在 6.1.3 节 中 给 大 家 做 详细 介绍 ， 这 里 我 们 需要 理解 的 是 ， 本 


节 介绍 的 “调试 框架 体系 ”和 之 前 我 们 说 讲 的 “API 接 口 体系 ”两 者 结合 起 来 才 是 比较 完整 的 微 博 服务 端 应 用 的 “基础 框架 体系 ” ， 在 这 个 体系 下 我 们 可 以 快速 高 效 地 开发 出 各 种 移动 互联 网 应 用 ， 也 许 在 实 
际 项 目 中 使 用 的 开发 框架 甚至 编程 语言 都 各 不 相同 ， 但 是 开发 思路 却 是 通用 的 ， 大 家 可 以 细 细 体会 一 下 。 


小 贴 士 : 这 里 我 们 之 所 以 用 到 “体系 ”这 个 词 ， 是 因为 希望 大 家 能 够 把 本 服务 端 实例 的 整体 思路 理解 清楚 ， 以 便 后 面 可 以 利用 本 框架 本 身 或 者 类 似 的 思路 来 快速 高 效 地 开发 移动 互联 网 应 用 的 服务 端 。 


5.1.3 ”核心 类 库 设计 


前 面 我 们 根据 设计 的 思路 给 大 家 介绍 了 微 博 服务 端 实例 的 “基础 框架 结构 ” | MATTE 


务 端的 核心 类 库 大 体 介绍 一 下 ， 然 后 再 挑选 其 中 比较 重要 的 几 个 类 库 做 重点 介绍 。 


类 库 名 


表 5-1 服务 端的 核心 类 库 


类 库 文件 


介绍 的 是 实例 的 核心 类 库 。 为 了 让 大 家 能 够 快速 地 掌握 诸多 底层 类 库 的 使 用 方法 ， 我 们 先 在 表 5-1 中 把 微 博 服 


使 用 说 明 


Demos_App 


Demos App Server 


Demos App Website 


Demos Cli 


Demos Dao 


Demos Dao Core 


Demos Util 


Demos Util Image 
Demos Util Session 
Demos Util Url 


lib/Demos/App.php 


lib/Demos/App/Server.php 


lib/Demos/App/Website.php 


lib/Demos/Cli.php 


lib/Demos/Dao.php 


lib/Demos/Dao/Core.php 
lib/Demos/Util.php 
lib/Demos/Util/Image.php 


lib/Demos/Util/Session.php 
lib/Demos/Util/Url.php 


App 应 用 逻辑 的 基 类 ， 继 承 自 Hush. App 

所 有 API 控制 器 的 基 类 ， 继 承 自 Hush Service 
所 有 页 面 控制 器 的 基 类 ， 继 承 自 Hush Page 

所 有 后 台 可 执行 程序 的 基 类 

所 有 DAO 对 象 的 基 类 ,继承 自 Hush Db Dao 
数据 库 demos core 下 面 所 有 DAO 的 基 类 
所 有 工具 类 的 基 类 ,继承 自 Hush Util 

与 图 片 处 理 方法 相关 的 工具 类 

与 Session 会 话 方 法 相关 的 工具 类 

与 URL 路 径 相关 的 工具 类 


下 面 我 们 会 结合 


“基础 框架 设计 ”中 的 MVC 分 层 的 设计 思路 ， 从 上 面 这 些 类 库 中 抽取 出 比较 重要 且 有 代表 性 的 类 库 给 大 家 分 别 介绍 一 下 。 在 此 之 前 ,我 们 需要 先 了 解 一 下 “命名 空间 ”的 概念 ， 其 实 命 


名 空间 的 出 现 就 是 为 了 防止 类 名 之 间 的 冲突 问题 ， 对 于 一 个 设计 良好 的 项 目 类 库 来 说 ， 制 定 一 个 命名 空间 是 非常 有 必要 的 。 我 们 可 以 看 到 上 面 提 到 的 所 有 类 库 都 是 被 放 在 lib/Demos 目 录 下 并 以 Demos 单 词 


开头 ， 那 么 我 们 则 可 以 认为 Demos 就 是 本 微 博 实例 项 目 命名 空间 


冲突 。 


1.Demos App 类 


的 名 称 ， 由 于 命名 空间 的 命名 一 般 和 项 目的 名 称 有 关 ， 所 以 很 容易 形成 唯一 的 类 名 规则 ， 避 免 与 其 他 的 项 目 类 库 或 者 公用 类 库 中 的 类 名 发 生 


其 实 ， 前 面 在 介绍 基础 框架 的 运行 逻辑 时 ， 已 经 给 大 家 介绍 了 一 些 关于 Demos App 类 的 使 用 ， 此 类 是 控制 整个 服务 端 应 用 逻辑 的 基 类 ， 一 般 来 说 都 是 供给 应 用 的 入 口 程序 所 使 用 ， 所 以 严格 来 说 不 应 
该 属于 MVC 三 层 之 内 ， 而 该 算是 这 三 层 之 上 的 “总 控 层 ”; 此 外 ， 此 类 继承 自 Hush Framework 的 Hush_App 类 ， 在 具体 使 用 时 此 类 主要 用 于 设置 应 用 运行 所 需 的 基础 配置 ， 包 含 的 主要 方法 及 用 法 如 下 所 


示 。 


-setDebug: 设置 是 否 打开 调试 模式 ， 此 模式 下 系统 会 把 所 有 捕捉 到 的 异常 抛 出 到 页 面 上 ， 显 而 易 见 的 是 此 模式 比较 适合 调试 程序 ， 但 是 正式 上 线 时 却 是 必须 要 关闭 的 。 
- setErrorPage: 用 于 给 应 用 设置 404 页 面 ， 也 就 是 服务 器 无 法 找到 的 页 面 。 
-setTplDir: 用 于 设置 应 用 模板 目录 ， 一 般 用 于 带 页 面 的 普通 互联 网 应 用 程序 中 ， 也 就 是 框架 结合 Smarty 模 板 引 擎 时 ， 所 以 在 微 博 应 用 中 并 没有 用 到 。 


“ addAppDir: 实际 上 就 是 添加 应 用 的 控制 器 类 库 目 录 ， 此 函数 可 以 被 多 次 调用 ， 每 次 添加 一 个 类 库 目录 ， 比 如 在 本 应 用 中 就 有 API 接 口 (Server) 和 网 页 应 用 (Website) 两 种 控制 器 类 的 目录 ， 我 们 都 
在 index.php 入 口 文件 中 设置 过 。 


: addMapFile: 设置 应 用 的 路 径 映射 文件 名 称 ， 这 部 分 内 容 在 前 面 我 们 也 已 经 给 大 家 介绍 过 了 ， 本 应 用 的 映射 文件 就 是 etc/ 目 录 下 的 app.mappingini 文 件 。 
“ run: 当然 在 应 用 程序 已 经 完成 所 有 的 设置 之 后 ， 别 忘 了 使 用 本 方法 打开 应 用 程序 的 运行 逻辑 ， 否 则 页 面 是 不 会 执行 的 。 
小 贴 士 : “总 控 层 ”的 说 法 虽然 比较 抽象 ， 但 是 从 整个 框架 的 结构 上 来 分 析 ， 应 该 可 以 算是 对 Demos_App 类 所 处 位 置 的 比较 准确 的 档 述 了 。 


2.Demos App_Server 类 


Demos_App_Server 类 是 所 有 API 接 口 以 及 调试 接口 的 基 类 ， 所 以 该 基 类 是 非常 重要 的 ， 应 该 可 以 算是 MVC 层 次 中 最 核心 的 部 分 之 一 。 接 下 来 ， 我 们 把 此 类 的 主要 代码 摘录 到 代码 清单 5-6 中 ， 大 家 可 以 
参照 代码 中 的 注释 先 阅读 其 中 主要 方法 的 逻辑 。 


代码 清单 ”5-6 


class Demos_App Server extends Hush Service 


{ 

// 消息 字符 数组 

protected $ msgs = array(); 

// 初始 化 过 程 回调 方法 

public function _ init () 

{ 
parent:: init(); 
// 初始 化 数据 库 操 作 类 
require once 'Demos/Dao.php'; 
Sthis->dao = new Demos Dao(); 
// 初始 化 统一 的 路 径 处 理 类 
require_once 'Demos/Util/Url.php'; 
$this-»url = new Demos Util Url(); 
// 初始 化 Session 会 话 处 理 类 
require_once 'Demos/Util/Session.php'; 
$this->session = new Demos Util Session(); 


l 

// 类 销毁 过 程 回调 方法 
public function _ done () 
{ 


parent:: done(); 


} 

// URL 路 径 跳 转 方法 

public function forward (Surl) 

{ 
Hush Util::headerRedirect (Sthis-»url-»format (Surl)); 
exit; 


$ 
// 按照 协议 打印 API 接 口 的 处 理 结果 
public function render ($code, $message, $result = '') 
{ 
// 组 合 返回 数组 
if (is array($result)) { 
foreach ((array) $result as $name => $data) { 
if (strpos($name, '.list')) { 
$model = trim(str_replace('.list', '', $name)); 
foreach ((array) $data as $k => $v) { 
Sresult [$name] [$k] = M($model, $v); 
} 
} else { 
$model = trim($name); 
$result[$name] = M($model, $data); 
} 
} 


l 
// 按照 协议 返回 


echo json_encode (array ( 


"code" => $code, 
'message' => $message, 
'result' => $result 


)); 


exit; 


} 
// API 接口 验证 登录 方法 
public function doAuth () 
{ 
if (!isset($ SESSION['customer'])) { 
$this->render('10001', 'Please login firstly.'); 
} else { 
$this-»customer = $_SESSION['customer']; 
] 


} 
// 调试 后 台 验 证 登录 方法 
public function doAuthAdmin () 
{ 
if (!isset($ SESSION['admin'])) ( 
$this-»forward($this-»apiAuth); // auth action 
) else ( 
$this->admin = $ SESSION['admin']; 
} 


我 们 可 将 此 类 中 的 方法 ， 分 为 以 下 两 类 来 看 待 和 使 用 。 


“ 回调 方法 : 此 类 型 的 函数 包括 _init () 初始 化 回调 方法 和 _done () 销毁 回调 方法 ， 在 本 基 类 中 这 两 个 方法 分 别 负 责 的 是 控制 器 在 “类 对 象 初始 化 ”和 “类 对 象 销毁 ”两 个 阶段 所 要 做 的 事情 。 我 们 
可 以 从 代码 逻辑 中 看 到 ， 前 面 一 个 阶段 我 们 初始 化 了 一 些 控制 器 逻辑 必须 使 用 的 对 象 ， 比 如 DAO 基 类 的 对 象 等 ， 而 这 些 对 象 我 们 都 可 以 在 控制 器 子 类 中 直接 使 用 ; 后 面 一 个 阶段 主要 做 的 则 是 一 些 关于 对 象 
销毁 和 回收 的 工作 。 这 类 回调 函数 一 般 都 是 可 以 在 子 类 中 被 重 写 的 ， 我 们 常常 会 在 这 些 方法 中 放 入 一 些 与 各 个 控制 器 逻辑 相关 的 代码 来 使 用 。 


: 公用 方法 : 此 类 中 除了 回调 方法 之 外 的 都 可 以 算是 公用 方法 ， 这 些 方法 都 各 有 各 的 用 处 ， 比 如 forward 路 径 跳 转 方法 以 及 render 结 果 打印 方法 等 。 此 类 方法 在 控制 器 子 类 中 使 用 时 都 可 以 直接 使 用 $this 变 
量 来 调用 ， 非 常 方便 实用 。 


3.Demos Cl 类 


在 前 面 介绍 PHP 基 础 时 我 们 给 大 家 讲 过 ，PHP 在 项 目 中 一 般 来 说 会 有 两 种 使 
一 个 完整 的 项 目 ， 本 微 博 服务 端 实例 当然 也 包括 后 台 脚本 这 个 部 分 的 功能 ， 不 过 这 个 部 分 的 内 容 相对 不 是 非常 重 


大 家 需要 知道 的 是 ， 在 本 实例 项 目 中 我 们 会 使 


bin/ 


ES 


[H 


的 可 执行 脚本 来 执行 后 台 程序 ， 而 与 后 台 脚 本 相关 的 逻辑 代码 都 在 lib/Demos/Cli/ 


方法 ， 除 了 我 们 之 前 一 直 


介绍 的 基于 HTTP 
， 所 以 这 旦 


民 务 器 的 网 络 应 上 
只 对 这 个 部 分 的 


编程 之 外 ， 还 有 一 种 就 是 上 
内 容 做 一 个 简单 的 介绍 。 


在 后 台 可 执行 脚本 的 编程 ; 而 作为 


目录 下 ， 这 些 逻 辑 控制 器 类 都 是 继承 自 Demos_Cli 基 类 


的 。 执 行 时 我 们 会 先 从 命令 行 工具 进入 项 目的 bin/ 


db help 
db backup 


db recover 
doc help 
doc build 
help help 
sys help 
sys init 


录 下 ， 输 入 cli 命 令 后 按 下 
似 的 规则 被 映射 到 对 应 类 库 方法 中 去 ， 比 如 其 中 的 文档 生成 命令 为 “cli doc build” , 


回 


车 键 ， 我 们 就 可 以 看 到 


图 | 


中 支持 的 所 有 的 命令 行列 表 了 ， 如 


5-8 所 示 ; 而 这 些 命令 行 的 逻辑 则 会 按照 和 控制 器 路 径 类 


BJM 


对 应 逻辑 就 在 lib/Demos/CIVDoc.php 文 件 中 的 Demos_ CIi_Doc 类 的 buildAction 方 法 中 。 


D: \Ec lipse_M\works pace \android—php\app Wemos \server\bin> 


关于 这 部 分 的 内 容 是 在 MVC 三 
在 这 些 代码 中 大 家 会 学 到 很 多 PHP 


H 


数据 库 操 作对 象 (DAO) 的 概念 我 们 前 


们 可 以 看 到 此 类 的 代码 非常 简短 ， 其 中 仅 包 含 一 个 静态 方法 load 


代码 清单 5-7 


class Demos Dao extends Hush Db Dao 
{ 
// 用 于 加 载 项 目的 数据 库 操 作 类 的 方法 


public static function load ($class_1 


{ 
static $ model = array(); 
if(!isset($ model[$class name])) 
require once 'Demos/Dao 


$ model[$class name] = 


return $ model[$class name]; 


= 
= 


然 也 继承 
法 。 


图 5-8 


cli 命令 行 运行 结果 


层 之 外 的 ， 一 般 来 说 我 们 只 需要 执行 相关 命令 完成 所 需 操作 即 可 ， 不 需要 分 析 这 些 罗 辑 的 代码 ; 但 是 如 果 有 时 间 的 话 ， 我 建议 大 家 也 可 以 去 阅读 一 下 这 部 分 的 代码 ， 
于 系统 操作 和 文件 目录 操作 的 经 验 和 技巧 。 


已 经 接触 得 很 多 了 ， 作 为 MVC 三 层 中 最 接近 数据 的 一 层 ， 也 是 应 | 


name) 


{ 
/' 


new $class name () ; 


. str replace(' ', '/', $class name) . ' 


EjHush Framework 的 DAO 基 类 ， 但 是 此 类 的 主要 功能 并 不 在 了 


Demos_Dao_Core 类 同样 也 属于 MVC 三 层 中 的 


代码 清单 5-8 


Class Demos Dao Core extends Demos Dao 


{ 

// 数据 库 名 

const DB NAME = 'demos_core'; 

// 构造 方法 

public function _ construct () 

{ 
// %%Xetc/database.mysql .php'? 
parent:: í 
// 绑 定 此 类 的 数据 库 名 
Sthis-> bindDb(self::DB NAME); 


我 们 可 以 看 到 Demos_Dao_Core 的 代码 非常 简单 ， 密 密 几 行 代码 就 把 这 个 DAO 基 类 写 好 了 ,而 后 
可 以 把 一 个 Model 层 的 基 类 实现 呢 ? 简单 来 说 ， 这 就 是 “代码 封装 ”的 力量 ; 


Model 


的 数据 库 配置 类 对 象 


construct (MysqlConfig: :getInstance()); 


屋 的 部 分 ， 它 继承 


Demos Dao 类 ， 


实现 数据 库 操作 类 的 数据 操作 逻辑 ， 而 是 


框架 中 比较 核心 的 部 分 ， 我 们 需要 重点 关注 一 下 。 下 面 就 是 Demos_Dao 类 的 全 部 代码 ， 我 


Hi 


于 加 载 对 应 目录 下 的 DAO 类 ， 而 这 个 方法 的 逻辑 也 非常 简单 ( 见 代码 清单 5-7) ， 大 家 可 以 参考 注释 进行 阅读 。 


-php'; 


于 构造 数据 库 表 的 DAO 对 象 ， 我 们 在 后 


介绍 具体 逻辑 代码 时 大 家 也 会 看 到 此 类 


也 是 Hush_Db_Dao 的 子 类 ， 代 码 清单 5-8 就 是 此 类 的 完整 代码 。 


因 


的 常见 的 数据 库 操作 方法 (如 CRUD 方 法 ) 的 具体 使 


， 大 家 可 以 参考 前 


H 


Demos_Util 类 顾名思义 是 本 应 
因为 大 部 分 的 方法 我 们 已 经 封装 到 


框架 的 工 


体 来 说 ， 因 为 大 
3.6.4 节 中 关于 “模型 


我 们 在 微 博 项 目 中 用 到 的 所 有 的 DAO 类 都 将 继承 自 此 类 。 也 许 你 会 觉得 奇怪 ， 怎 么 这 么 少 的 代码 就 
部 分 的 DAO 类 中 所 要 使 用 的 方法 都 已 经 被 Hush Framework 框 架 封装 到 了 Hush_Db_Dao 类 中 。 至 于 此 类 中 


层 ”介绍 部 分 的 内 容 ， 如 果 还 有 问题 ， 建 议 大 家 返回 对 应 章节 复习 一 下 。 


H 


类 ， 此 类 的 大 部 分 代码 都 是 静态 方法 ， 是 可 以 直接 使 
Hush Framework 中 的 Hush_Util 类 中 去 了 ， 这 里 列举 一 些 比较 常 


的 。 大 家 查看 此 类 代码 时 会 发 现 Demos_Util 类 继承 自 Hush_Util 类 ， 但 是 整个 类 的 代码 却 是 空 的 ， 这 
的 静态 方法 让 大 家 先 熟悉 一 下 。 


“ trace 方法 : 传 和 Exception 对 象 即 可 打印 出 该 Exception 的 跟踪 调试 信息 ， 此 方法 常用 于 开发 代码 调试 中 。 


“ param 方 法 : 用 于 接受 GET 或 POST 过 来 的 参数 ， 可 以 用 静态 方法 调用 ， 也 可 在 控制 器 类 中 通过 使 用 “$this->param ($name) ”的 方法 来 使 用 。 


: COokie 方 法 : 用 于 读 取 和 设置 系统 cookie 变 量 中 的 数据 。 


:Session 方法 : 用 于 读 取 和 设置 系统 session 变 量 中 的 数据 。 


:jsRedirect 方 法 : 使 用 JavaScript 来 进行 页 面 跳 转 ， 这 种 跳 转 一 般 用 于 网 页 类 型 的 应 用 中 。 


: headerRedirect 方 法 : 设置 HTTP 响 应 代码 并 进行 页 面 跳 转 ， 这 种 跳 转 方法 使 用 的 场景 比较 广泛 ， 最 常见 的 有 301 跳 转 和 302 跳 转 。 


| Cur| 方 法 : 模拟 HTTP 请 求 进行 远程 访问 的 方法 ， 我 们 常 在 项 目 中 使 用 此 方法 来 远程 访问 第 三 方 接口 、 模 拟 客户 端 请 求 ， 甚 至 用 于 抓 取 网 页 等 。 


| ping 方 法 : 用 于 检测 远程 服务 器 的 端口 是 否 可 访问 ， 此 方法 在 做 后 台 监 控 系 统 时 特别 好 用 。 


: str 系列 方法 : 


array 系列 方法 : 与 数组 操作 相关 的 系列 方法 ， 命 名 规范 也 和 PHP 原 生 函 数 一 样 。 


-dir 系列 方法 : 与 本 地 目录 操作 相关 的 系列 方法 ， 包 括 创建 、 复 制 、 删 除 等 操作 。 


- Uuid 方 法 : 


小 贴 士 : 1) 上 面 提 到 “系列 方法 ”的 意 


生成 “通用 唯一 识别 码 ” 的 方法 。 


思 是 


与 字符 串 操作 相关 的 系列 方法 ， 采 用 和 PHP 原 生 函 数 一 样 的 命名 规范 ， 以 str_ 作 为 所 有 字符 串 方 法 前 缓 。 


思 是 这 里 包含 的 不 仅仅 只 是 一 个 方法 ， 而 是 一 组 方法 ， 有 具体 的 方法 说 明 可 以 参考 Hush Framework 的 API 文 档 。 


2) UUID 的 含义 是 通用 唯一 识别 码 (Universally Unique Identifier) ， 是 一 个 软件 建构 的 标准 。UUID 的 目的 是 让 分 布 式 系统 中 的 所 有 元 素 ， 都 能 有 唯一 的 辨识 记号 ， 而 不 需要 通过 中 央 控制 端 来 做 辨识 资 


讯 的 指定 。 


5.14 ”服务 端的 MVC 与 SOA 


MVC 的 概念 我 们 之 前 已 经 介绍 过 多 次 ， 在 3.6.3 节 中 已 经 介绍 了 底 


节 中 对 应 


在 服务 端 编程 的 领域 ， 除 了 MVC 这 个 相对 重要 的 概念 之 外 ， 我 们 还 需要 认识 SOA (Service Oriented Architecture) ， 也 就 是 画 
越 复杂 ， 为 了 降低 系统 复杂 度 以 及 模块 间 的 耦合 度 ， 我 们 采 


加 清晰 、 组 件 整合 


另外 ， 在 传统 


的 JSON 协 议 来 蔡 代 XML 作为 其 通信 协议 。 由 于 JSON 比 XML 更 


实际 上 ， 在 本 


正 是 轻 量 级 的 JSON。 


框架 代码 目录 结构 的 说 明 来 看 ， 实 例 服务 端 程序 的 Model 层 的 类 库 文 件 位 了 
于 “lib/Demos/App/” 目 录 下 ; 当然 这 并 不 是 阅 我 们 只 需要 注意 这 几 个 目录 下 的 程序 文件 ， 比 如 lib 
MVC 设 计 思 路 ， 为 之 后 的 接 


编码 工作 打 好 基础 。 


类 似 于 “分 而 治之 ”的 方法 ， 把 其 


F “iib/DemosDao/” 目 录 之 下 ，View 层 的 类 库 目 录 对 应 


实际 上 ， 微 博 服务 端 框架 的 设计 思路 与 Hush Framework 框 架 大 同 小 异 。 结 合 5.1.1 
的 是 “tpl/” 文 件 目录 ， 而 Controller 层 的 代码 文件 则 被 放置 


录 下 面 还 有 非常 重要 的 基 类 和 工 


中 一 些 重 


H 


向 


可 


变 得 更 加 灵活 ， 还 可 以 大 大 提高 功能 模块 的 重 


其 


的 SOA 软 件 架构 中 ， 通 常会 使 有 


tT XML 


S 


性 和 稳定 性 。 


0 简单 轻便 ， 也 更 能 降低 网 络 请 求 带 来 的 带宽 和 资源 消耗 ， 所 以 在 业务 描述 不 是 非常 复杂 的 情况 下 ， 更 容易 受到 使 


书 的 微 博 应 


实例 中 的 
因此 ， 对 于 如 何 使 


B 务 端 部 分 ， 我 们 


也 采 
PHP 来 开发 SOA 的 服务 端 应 


了 SOA 的 设计 理念 ， 把 微 博 应 有 


的 问题 来 说 ， 本 实例 还 是 


X; 对 了 


民 务 体系 架构 的 概念 。 


随 着 软件 行业 的 不 断 发 


肛 务 描述 语言 WSDL (Web Services Description Language) 作为 各 个 Service 之 间 的 通信 协议 ， 但 是 现在 也 有 不 少 Service 服 务 采 


我 们 来 说 ， 最 重要 的 事情 是 理解 和 熟悉 实例 应 


框架 中 的 


展 ， 服 务 端的 功能 越 来 
的 业务 模块 剥离 出 来 ， 成 为 独立 的 Service 来 提供 服务 ， 这 种 做 法 不 但 可 以 让 服务 端的 业务 逻辑 更 


更 轻 量 级 


者 人 


] 的 青睐 。 


的 业务 逻辑 封装 到 服务 端 程序 中 去 ， 并 采 上 


Service 服 务 的 方式 提供 给 微 博客 户 端 使 


有 很 高 参考 价值 的 。 另 外 ， 正 是 因 


为 引入 了 SOA 的 概念 ， 


我 们 的 服务 端 API 接 口 控 名 


了 "lib/Demos/App/Server/" 目录 下 ， 而 每 个 控制 器 类 的 后 缀 名 都 是 Server， 而 非 Controller。 关 于 这 点 ， 也 请 大 家 在 阅读 时 注意 ， 好 好 理解 、 消 化 一 下 。 


5.2 ”客户 端 程序 架构 设计 


的 "Ee", gebe 
础 上 进行 开发 的 。 


当然 , 我 们 客 


5.2.1 


和 介绍 服务 端 架 构 的 流程 一 样 ， 我 们 先 来 观察 微 博客 户 端 程序 的 基础 框架 设计 ， 如 
上 搭建 起 来 的 ， 我 们 可 以 把 应 


都 是 为 了 加 快 开发 效率 、 减 少 元 余 代码 ， 让 客 ， 


户 端 程序 的 基础 框架 是 不 可 能 脱离 Android 应 


端 应 


前 面 我 们 介绍 了 微 博 实例 服务 端的 基础 架构 ， 那 么 紧 接着 我 们 来 学 习 一 下 Android 客 户 端 代码 的 基础 架构 吧 。 和 服务 端 一 样 ， 我 们 会 按照 MVC 的 设计 方法 对 Android 的 基础 应 


开 


程序 开发 更 加 轻松 。 通 过 不 断 的 积累 和 优化 ， 我 们 逐渐 形成 了 一 套 通 


配置 和 UI 界 


H 


基础 框架 设计 


程序 框架 大 体 分 为 “程序 类 库 ” 


和 “核心 类 库 ” 两 个 


=. 
= 


框架 的 ， 准 确 来 说 应 该 是 在 Android 应 | 
的 封装 、 网 络 请 求 的 处 理 、 安 全 验证 逻辑 以 及 数据 持久 化 功能 等 ， 至 于 应 


5-9 所 示 。 和 服务 端 架构 不 同 ， 客 户 端 程序 的 框架 结构 没有 那么 多 的 层 ; 


的 框架 ， 本 书 的 微 博 实例 应 


就 是 在 这 


， 而 通信 协议 使 
器 类 都 被 归 类 到 


发 框架 进行 合理 
么 一 个 基础 框架 的 基 


框架 的 基础 上 开发 而 成 的 ， 该 基础 框架 主要 负责 功能 逻辑 相关 的 内 容 处理 ， 比 如 模型 层 和 控制 器 层 
相关 的 工作 还 是 交 由 Android 应 用 框架 来 处 理 。 


框架 都 是 在 Android 应 


框架 的 基础 


图 5-9 客户 端 基 础 框架 设计 


从 图 5-9 中 ， 我 们 可 以 看 出 程序 框架 把 Android 应 用 开发 的 各 个 组 件 和 模块 封装 并 归 类 到 了 几 个 不 同 的 类 包 之 下 ， 形 成 框架 的 程序 类 库 ， 而 这 些 程序 类 包 都 围绕 在 核心 类 包 的 周围 ， 构 成 了 一 个 完整 的 杠 
架 结构 。 由 于 本 实例 的 客户 端 框架 的 层次 不 像 前 面 介绍 的 服务 端 框架 分 得 那么 细 ， 所 以 这 些 类 包 中 具体 的 代码 逻辑 和 实例 应 用 的 功能 关系 比较 紧密 ， 我 们 会 在 第 7 章 中 给 大 家 做 详细 的 剖析 ， 本 节 将 对 这 几 个 
类 包 的 功能 进行 一 下 讲解 ， 让 大 家 熟悉 一 下 这 些 类 包 的 功能 。 


小 贴 士 : Java 中 有 类 包 (package) 的 概念 ， 所 以 我 们 对 于 归 类 在 一 个 源 代码 目录 下 面 的 类 库 叫 作 “ 类 包 ”; 而 PHP 中 没有 包 的 概念 ， 所 以 我 们 称 之 为 “类 库 ”。 


为 了 让 大 家 能 够 更 快 、 更 方便 地 掌握 每 个 类 包 的 功能 ,我 们 把 程序 框架 中 的 所 有 类 包 的 功能 归纳 到 表 5-2 中 ， 大 家 可 以 对 照 微 博 应 用 的 源 代码 理解 一 下 。 


最 后 ， 我 们 还 需要 知道 ， 本 书 微 博 实例 的 客户 端 程序 框架 实际 上 就 是 对 Android 应 用 项 目 中 经 常 使 用 的 代码 逻辑 进行 归纳 和 封装 ， 最 终 还 是 建立 在 Android 应 用 框架 的 基础 上 ， 所 以 掌握 Android 应 用 框 
架 开发 的 基础 知识 是 往 下 学 习 的 前 提 。 当 然 ， 如 果 大 家 对 Android 开 发 的 基础 知识 还 不 是 很 熟悉 的 话 ， 请 返回 第 2 章 去 复习 Android 应 用 开发 的 基础 知识 。 


表 5-2 客户 端 类 包 列表 


核心 类 包 

com.app.demos.base 核心 基础 类 包 ， 包含 了 所 有 基础 类 包 的 基础 类 
com.app.demos.util 核心 工具 类 包 ， 包 含 了 项 目 中 所 有 用 到 的 工具 类 
基础 类 包 

com.app.demos.ui 界面 控制 器 类 包 ，MVC 中 的 Controller Jz 
com.app.demos.model 基础 模型 类 包 ，MVC 中 的 Model Jš 
com.app.demos.service 基础 服务 类 包 ， 包 含 了 所 有 与 Android 服务 有 关 的 类 
com.app.demos.dialog 基础 对 话 框 类 包 ， 包 含 了 所 有 与 Android 对 话 框 有 关 的 类 
com.app.demos. list 基础 列表 类 包 ， 包 含 了 所 有 与 Android 列表 有 关 的 类 
com.app.demos.demo 网 页 示例 类 包 ， 主 要 存放 网 页 类 型 的 Activity 控制 器 类 
com.app.demos.sqlite 数据 库 操 作 类 ， 主 要 存放 SQLite 数据 库 的 操作 类 
com.app.demos.test 测试 类 包 ， 包 含 了 所 有 与 测试 功能 有 关 的 类 


5.2.2 ”核心 类 包 设 计 


从 5.2.1 节 的 内 容 中 可 以 了 解 到 微 博 实例 框架 的 核心 类 包 主 要 有 两 个 : 一 个 是 应 用 框架 的 核心 基础 类 包 ， 也 就 是 com.app.demos.base 类 包 ， 里 面包 含 了 绝 大 部 分 功能 模块 的 基 类 ， 这 些 类 是 应 用 中 其 他 
功能 类 的 基 类 ， 也 是 应 用 框架 中 最 为 核心 的 部 分 ; 另外 一 个 则 是 核心 工具 类 包 ， 也 就 是 com.app.demos.util 类 包 ， 这 里 面包 含 了 所 有 的 工具 类 ， 也 是 客户 端 应 用 开发 中 必 不 可 少 的 部 分 。 下 面 我 们 将 给 大 家 
介绍 这 两 个 类 包 中 核心 类 的 设计 思路 。 


1 .核心 基础 类 包 (com.app.demos.base) 


首先 ， 我 们 来 了 解 一 下 核心 基础 类 包 中 各 个 类 库 之 间 的 关系 图 (如 图 5-10 所 示 ) ， 图 中 左 侧 一 列 是 核心 基础 类 包 中 的 主要 基 类 ， 右 侧 一 列 则 是 建立 在 这 些 基 类 之 上 的 对 应 基础 类 包 ， 比 如 登录 界面 的 控 


制 器 类 UiLogin 就 是 BaseUi 的 子 类 ， 而 所 有 列表 组 件 类 的 基 类 是 BaseList 等 。 下 面 我 们 把 关系 图 左 侧 一 列 所 涉及 的 几 个 核心 类 的 基本 内 容 给 大 家 介绍 一 下 。 


com.app.demos.ui.Ui* 


com.app.demos. dialog.* 


——— 


=< 


com.app.demos.model.* 


com.app.demos.service.* 


图 5-10 ”客户 端 核心 基础 类 包 


(1) BaseUi 相 关 (&lf&BaseTask/BaseTaskPool/BaseHandler) 


在 Android 应 用 项 目的 开发 过 程 中 ,我们 经 常 把 Activity 当 作 MVC 概 念 中 的 控制 器 来 使 用 ， 我 们 通常 称 之 为 界面 控制 器 ， 统 一 放置 于 com.app.demos.ui 类 包 下 ， 并 且 以 Ui 作为 所 有 界面 控制 器 类 名 的 前 
缀 ;在 应 用 程序 框架 中 BaseUi 是 所 有 Activity 界 面 控制 器 类 的 基 类 ， 里 面 除了 重 写 部 分 Activity 生 命 周 期 中 的 方法 之 外 ， 还 封装 了 大 部 分 在 Android 应 用 开发 中 可 能 会 用 到 的 方法 和 组 件 ， 下 面 我 们 先 挑选 其 
中 比较 常用 的 且 和 业务 逻辑 无 关 的 方法 给 大 家 介绍 一 下 。 


小 贴 士 : UI (User Interface) 即 用 户 界面 的 缩写 ， 以 此 作为 应 用 界面 控制 器 的 类 名 前 缓 相对 比较 合适 ， 当 然 大 家 可 以 根据 实际 情况 来 制定 合适 的 规则 。 另 外 ， 这 种 指定 类 名 前 缓 或 者 后 缓 的 做 法 在 开发 过 
程 中 经 常 使 用 ， 其 目的 是 为 了 对 类 库 进 行 更 好 的 归 类 ， 增 加 代码 的 可 读 性 和 可 维护 性 。 


.toast: 用 于 弹出 提示 信息 ， 此 方法 重 写 Android 原 生 的 toast 方 法 ， 让 其 在 本 框架 中 更 容易 使 用 。 


: overlay: 在 目前 界面 上 方 覆 盖 一 个 新 的 Activity 层 ， 此 模式 中 的 用 户 行为 和 Andtoid 任 务 中 的 默认 模式 (standard mode) 比较 类 似 ， 最 上 层 可 通过 本 类 的 doFinish 方 法 关闭 ， 在 用 户 看 来 就 是 返回 上 一 个 
界面 。 


: forward: 关闭 当前 的 Activity 并 打开 一 个 新 的 Activity 层 ， 此 模式 中 的 用 户 行为 和 Android 任 务 中 的 singleTask 模 式 比 较 类 似 ， 但 是 要 注意 的 是 由 于 此 时 Activity 栈 中 只 存在 一 个 Activity ， 所 以 如 果 此 时 调 
用 doFinish 方 法 ， 用 户 将 直接 退出 应 用 。 


: getContext: 由 于 我 们 在 Activity 逻 辑 编程 时 可 能 会 经 常会 用 到 本 Activity 的 上 下 文 Context 对 象 ， 而 getContext 方 法 可 以 快速 地 给 大 家 返回 此 对 象 以 方便 使 用 。 
: getHandler: 此 方法 会 返回 当前 Activity 所 绑 定 的 Handler 处 理 器 对 象 ， 关 于 Handler 处 理 器 的 使 用 马上 就 会 给 大 家 介绍 到 。 

-getLayout: 此 方法 有 多 种 重 载 形式 ， 根 据 不 同 的 传 入 对 象 可 以 返回 LayoutInflater 对 象 或 者 具体 的 View 对 象 。 

- openDialog: 可 根据 输入 弹出 提示 信息 对 话 框 ， 此 方法 使 用 框架 通用 的 对 话 框 模板 (在 com.app.demos.dialog 类 包 中 ) 。 

sendMessage: 发 送 消息 给 Handler 处 理 器 来 进行 对 应 处 理 ， 此 方法 也 有 多 个 重 载 的 方法 ， 可 发 送 不 同 参数 给 处 理 器 中 的 不 同 逻 辑 来 使 用 。 


: doTaskAsync: 开始 一 个 异步 任务 ， 对 于 用 户 来 说 就 是 做 一 个 动作 ; 而 这 里 我 们 只 需要 知道 ， 为 了 保证 主 UI 线 程 的 稳定 ， 在 Android 应 用 中 的 所 有 任务 都 是 异步 的 ; 关于 异步 任务 的 内 容 我 们 会 在 后 面 
的 7.4 节 中 做 详细 介绍 。 


从 前 面 的 方法 介绍 的 内 容 中 我 们 可 以 看 到 BaseUi 实 际 上 是 一 个 综合 性 的 类 ， 很 多 在 应 用 开发 中 需要 用 到 的 方法 和 逻辑 都 被 整合 到 此 类 之 中 。 除 前 面 介绍 的 方法 之 外 ， 还 有 几 个 类 是 比较 重要 的 ， 下 面 给 
大 家 一 一 讲解 。 


: BaseTask: 此 类 是 异步 任务 的 基 类 ， 所 有 的 异步 任务 都 是 从 这 个 类 衍生 出 来 的 ， 里 面 定义 了 任务 的 基本 属性 和 必要 方法 。 


: BaseTaskPool: 顾名思义 此 类 是 异步 任务 池 类 ， 我 们 会 为 新 添 的 每 个 任务 打开 一 个 线程 进行 处 理 。 此 类 本 身 就 是 使 用 Java 线 程 池 (ThreadPool) 实现 的 。 另 外 ， 此 类 已 经 被 整合 进 BaseUi 类 中 ， 主 要 用 
于 doTaskAsync 等 方法 中 。 


: BaseHandler: 基础 的 消息 处 理 器 类 ， 在 介绍 Android 开 发 基础 时 我 们 就 提 到 过 ， 为 了 保证 应 用 UI 主线 程 的 稳定 ，Android 使 用 了 一 套 消息 响应 机 制 来 处 理 从 主线 程 中 产生 出 来 的 异步 的 任务 ， 标 准 处 理 
过 程 如 下 : 在 任务 子 线程 里 的 异步 任务 完成 之 后 ， 会 发 送 一 个 消息 (Message) 给 消息 处 理 器 (Handler) ， 然 后 消息 处 理 器 会 根据 不 同 的 消息 进行 对 应 处 理 并 配合 主线 程 更 新 UI 界面 ， 具 体 的 处 理 逻 辑 可 以 参 
考 BaseHandler 类 中 的 handleMessage 方 法 。 


(2) BaseUiAuth 与 BaseUiWeb 


前 面 刚 介绍 过 BaseUi， 下 面 马 上 介绍 与 其 紧密 相关 的 两 个 子 类 BaseUiAuth 与 BaseUiWeb。BaseUiAuth 是 所 有 “框架 界面 ”的 基 类 (参考 4.4 节 ) ， 相 对 于 BaseUi 来 说 ， 增 加 了 应 用 菜单 和 界面 框架 
(顶部 导航 栏 和 底部 功能 选项 ) 的 逻辑 ， 登 录 以 后 的 绝 大 部 分 界面 控制 器 都 继承 自 BaseUiAuth 类 ， 如 微 博 列表 (UilIndex) 、 微 博 详 情 (UiBlog) 以 及 用 户 配置 (UiConfig) 界面 等 ， 实 例 代码 的 分 析 请 参 
考 第 7 章 中 的 相关 内 容 。 


BaseUiWeb 是 所 有 以 Web 方 式 运行 的 Activity 的 基 类 ， 也 继承 自 BaseUi。 该 类 除了 添加 了 Web 界 面 框架 通用 的 逻辑 之 外 ， 最 主要 的 区 别 就 是 多 了 一 个 startWebView 方 法 ， 此 方法 定制 了 本 控制 器 类 的 
内 赃 浏 览 器 ， 本 实例 中 也 有 两 个 例子 (在 com.app.demos.demo 类 包 下 ) 运行 在 这 个 基 类 之 上 。 其 实在 实际 项 目 中 ， 嵌 入 Web 页 面 作为 信息 展示 的 做 法 还 是 很 普遍 的 ， 因 为 使 用 Web 展 示 界面 一 方面 比较 
简单 ， 另 一 方面 也 方便 功能 修改 ， 所 以 这 部 分 内 容 也 是 需要 大 家 重点 关注 的 ， 具 体 实例 可 参考 7.11 节 中 的 内 容 。 


(3) BaseDialog 


BaseDialog 是 本 框架 中 的 基础 对 话 框 类 ,使 用 了 Dialog 类 和 WindowManager 的 LayoutParams 子 类 一 起 构造 了 一 个 完全 自 定义 的 对 话 框 ， 虽 然 在 实际 项 目 里 可 能 更 常 使 用 AlertDialog， 但 是 我 们 也 需 
要 掌握 一 些 更 基础 的 用 法 ， 因 为 一 般 来 说 ,使 用 越 基础 的 组 件 往往 能 获得 越 大 的 自由 度 ， 一 旦 到 了 能 派 上 用 场 的 时 候 就 知道 它 的 好 处 了 。 


(4) BaseList 


列表 List 组 件 应 该 算是 Android 应 用 中 最 常 使 用 的 组 件 之 一 ， 本 实例 应 用 中 大 部 分 的 列表 类 都 在 com.app.demos.list 类 包 中 ， 而 BaseList 就 是 这 些 列表 类 的 基 类 ， 继 承 自 BaseAdapter， 可 以 和 ListView 
组 件 配合 使 用 。 此 类 的 具体 使 用 方法 和 实例 代码 分 析 的 内 容 我 们 会 在 7.7.2 节 中 结合 微 博客 户 端的 代码 给 大 家 做 详细 分 析 。 


(5) BaseModel 


BaseModel 是 所 有 模型 类 的 基 类 ， 如 果 查 看 该 类 的 代码 大 家 就 能 看 到 BaseModel 类 目前 就 是 一 个 空 壳 ， 里 面 的 内 容 都 留 给 以 后 需要 使 用 时 再 添加 ， 另 外 它 所 有 的 模型 子 类 都 放 在 
com.app.demos.mode| 类 包 下 面 ， 模 型 类 和 服务 端 API 所 返回 的 模型 应 该 是 一 致 的 ， 如 果 你 有 心 的 话 可 以 去 对 比 一 下 ， 这 就 是 服务 端 与 客户 端 之 间 的 “桥梁 ”了 。 


(6) BaseService 


BaseService 是 所 有 服务 类 基 类 ， 和 BaseUi 有 点 类 似 的 是 该 类 也 提供 doTaskAsync 异 步 任 务 方法 ， 另 外 比较 重要 的 就 是 Service 服 务 特有 的 开启 (start) 和 关闭 (stop) 方法 。 另 外 ， 在 本 实例 中 目前 只 
有 一 个 Service 的 子 类 NoticeService， 存 放 在 com.app.demos.service 类 包 下 ， 我 们 会 在 7.5.4 节 中 对 Android 应 用 开发 中 使 用 Service 服 务 部 分 的 内 容 做 详细 介绍 。 


2. 核 心 工具 类 包 (com.app.demos.util) 


除了 核心 基础 类 之 外 ， 核 心 工具 类 也 是 非常 重要 的 ,该 类 包 中 包含 的 基本 都 是 一 些 非常 实用 的 ,与 业务 逻辑 无 关 的 静态 类 和 静态 方法 ， 我 们 可 以 在 任何 时 候 快 速 方便 地 使 用 。 比 如 ,我们 可 以 方便 地 使 
AppClient 类 进行 网 络 请 求 ， 也 可 以 使 用 AppUtil 类 中 的 静态 方法 快速 地 完成 某 些 字符 串 的 操作 。 


(1) AppClient 类 


对 于 大 部 分 的 Android 应 用 程序 来 说 ， 我 们 经 常 使 用 SDK 自 带 的 HttpClient 类 来 进行 HTTP 远 程 访问 ， 而 本 应 用 程序 框架 在 HttpClient 的 基础 上 进行 了 更 进一步 的 封装 ， 最 终 产 生 了 AppClient 类 ， 让 客 
户 端 程序 访问 API 接口 变 得 超级 简单 ， 示 例 代 码 见 代码 清单 5-9。 


代码 清单 5-9 


AppClient client = new AppClient ("http://www.google.com") ; 
String result = client.get(); 


我 们 可 以 看 到 这 里 仅 用 两 行 代码 就 完成 了 一 个 HTTP 的 GET 请 求 ， 把 Google 首 页 的 代码 “ 抓 取 ”下 来 ， 我 们 还 会 在 7.3 节 中 结合 实例 详细 介绍 一 下 关于 在 Android 应 用 程序 中 进行 网 络 通 信 的 相关 内 容 。 


(2) AppUtil 类 


AppuUtil 中 主要 包含 了 我 们 在 微 博 应 用 程序 开发 中 经 常用 到 的 静态 方法 ， 此 类 中 的 方法 有 两 类 ， 一 种 是 和 应 用 逻辑 完全 没有 关系 的 ， 比 如 一 些 字符 串 或 者 数组 的 便捷 操作 方法 等 ; 另外 一 种 是 和 应 用 罗 辑 
有 一 定 关系 的 方法 ， 比 如 解析 和 API 返回 结果 的 getMessage 方 法 等 。 另 外 ， 由 于 此 工具 类 在 应 用 编码 过 程 中 被 广泛 使 用 ， 因 此 关于 此 类 的 使 用 方法 我 们 会 在 后 面 介绍 客户 端 代 码 的 时 候 给 大 家 穿插 介绍 。 


(3) DBUtil 类 


DBUtil 顾 名 思 义 就 是 和 数据 库 相关 的 工具 类 ， 里 面 放 的 都 是 有 关 简 化 数据 操作 逻辑 的 方法 ， 比 如 对 于 时 间 字 段 的 操作 ， 以 及 对 于 图 片 信息 的 操作 等 。 对 于 微 博 应 用 来 说 虽然 客户 端的 数据 库 操作 被 “ 弱 
化 ”了 ， 但 是 掌握 DB 层 的 使 用 对 应 用 开发 来 说 还 是 非常 重要 的 。 


(4) HttpUtil 类 


根据 类 名 我 们 可 以 知道 HttpUtil 类 里 面 都 是 与 HTTP 网 络 请 求 相关 的 方法 ， 在 本 实例 代码 中 该 类 中 只 有 一 个 方法 getNetType， 用 于 获取 用 户 移动 设备 的 联网 方式 ， 在 7.3.2 节 中 会 详细 介绍 此 类 的 逻辑 和 


应 

(5) IOUtil 和 SDUtil 类 

IOUtil 和 SDUtil 两 个 类 中 的 方法 都 是 与 系统 1O 读 写 有 关系 的 ， 两 者 的 区 别 在 于 前 者 中 的 方法 属于 普通 IO 操作 ， 而 SDUtil 中 的 方法 都 是 与 SD 卡 中 的 文件 操作 有 关 的 。 在 本 实例 中 这 两 个 类 的 方法 基本 上 都 
和 图 片 有 关 ， 因 为 微 博 的 特点 就 是 需要 获取 大 量 的 图 片 信息 ， 当 然 如 果 大 家 以 后 使 用 本 框架 作为 基础 进行 开发 的 话 ， 可 以 在 这 两 个 类 中 补充 自己 所 需 的 1O 操 作 方法 。 


(6) UIUtil 类 


与 UI 相 关 的 工具 类 方法 都 会 被 放 到 这 个 类 中 。 昌 然 本 实例 中 此 类 的 方法 非常 少 ， 目 前 只 有 一 个 用 于 组 合用 户 信息 的 方法 getCustomerlnfo， 但 是 此 类 是 可 以 扩展 的 ; 当然 ， 其 他 UI 相 关 的 方法 也 可 以 放 
到 此 类 中 。 


前 面 介绍 了 微 博 应 用 客户 端 框架 核心 类 库 的 设计 思路 ， 以 及 其 中 重要 类 库 (包括 核心 基础 类 包 、 核 心 工具 类 包 ) 的 用 法 ， 这 些 知识 都 是 客户 端 程序 代码 编写 的 基础 ， 在 第 7 章 介 绍 微 博客 户 端 代码 实现 时 
都 会 用 到 ， 因 此 我 们 应 该 重视 对 本 节 内 容 的 学 习 和 理解 。 


5.2.3 Android 应 用 的 MVC 


前 面 已 经 介绍 过 许多 与 MVC 概 念 有 关 的 内 容 了 ， 微 博 应 用 的 服务 端 框架 Hush Framework 也 是 采用 该 设计 模式 来 实现 的 。MVC 的 最 大 好 处 就 是 把 应 用 程序 的 逻辑 层 和 界面 层 完全 分 开 ， 界 面 设计 人 员 
可 以 专心 进行 界面 开发 ， 而 程序 员 则 可 以 把 所 有 的 精力 放 在 逻辑 实现 上 。 下 面 我 们 把 微 博 应 用 客户 端 框架 中 的 MVC 设 计 思 路 归纳 如 下 。 


1.482 (Model) 


Android 应 用 中 的 模型 层 主要 包括 了 应 用 逻辑 的 业务 模型 类 以 及 数据 库 操作 类 两 部 分 。 对 于 微 博 应 用 客户 端 框架 来 说 ， 以 上 两 部 分 内 容 分 别 对 应 的 是 com.app.demos.model 类 包 与 
com.app.demos.sqlite 类 包 。 


2. 视 图 层 (View) 


Android 应 用 中 视 | 
7.11 节 中 的 内 容 。 


区 


恨 主 要 指 的 是 reslayout/ 目 录 下 的 XML 界面 模板 文件 ; 当然， 广义 上 看 ， 也 包括 res/ 目 录 下 的 所 有 资源 文件 。 此 外 ， 我 们 也 可 以 采用 Web 方 式 来 实现 应 用 界面 ， 这 点 大 家 可 参考 


3. 控 制 层 (Controller) 


Android 应 用 中 控制 层 的 逻辑 代码 通常 都 存在 于 Ul 界 面 对 应 的 Activity 类 中 。 在 微 博 应 用 客户 端 框架 中 ， 就 是 com.app.demos.ui 类 包 下 的 界面 控制 器 类 。 另 外 ， 这 也 是 为 什么 我 们 把 Activity 类 称 作 “ 界 
面 控制 器 类 ”的 原因 。 


实际 上 ，Android 应 用 项 目 本 身 已 经 非常 好 地 实践 了 MVC 的 设计 思路 ， 建 议 大 家 学 会 按照 MVC 的 思想 来 看 待 和 分 析 Android 应 用 的 程序 框架 ， 因 为 这 样 不 仅 可 以 帮助 我 们 更 好 地 学 习 Android 开 发 框 
架 ， 还 可 以 让 我 们 更 加 深入 地 理解 MVC 的 设计 模式 。 


5.3 ”客户 端 界面 架构 设计 


在 第 4 章 中 我 们 曾经 介绍 过 客户 端 界面 的 原型 设计 ， 但 是 ， 在 进行 应 用 开发 之 前 ， 我 们 还 需要 对 这 些 界面 原型 进行 进一步 的 补充 和 完善 ; 另外 ， 我 们 还 需要 构造 一 个 通用 的 界面 框架 来 规范 和 简化 之 后 应 
程序 的 开发 。 因 此 在 本 节 中 ， 首 先 会 给 大 家 介绍 一 下 如 何 设计 微 博 实例 应 用 的 界面 框架 ， 然 后 会 逐一 分 析 微 博 应 用 中 最 主要 的 几 个 功能 界面 ， 进 而 完成 整个 客户 端 界面 架构 的 设计 。 


5.3.1 ”界面 框架 设计 


界面 框架 设计 更 多 是 针对 “框架 界面 ”而 言 的 。 当 然 ， 本 书 的 微 博 实例 应 用 中 大 部 分 的 功能 界面 都 属于 “框架 界面 ”， 其 界面 布局 可 以 分 为 上 、 中 、 下 三 个 部 分 ， 如 图 5-11 所 示 。 实 际 上 ， 这 种 界面 布 
局 也 是 大 部 分 主流 移动 互联 网 应 用 所 采用 的 结构 ， 下 面 我 们 就 对 该 类 界面 中 的 三 个 部 分 逐个 进行 分 析 。 
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| am james huang ... 
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ERRATE 


图 5-11 微 博 界面 框架 


1. 顶 部 导航 栏 


项 部 导航 栏 需要 体现 应 用 界面 的 主题 ， 实 际 上 项 部 的 导航 栏 一 般 来 说 也 会 被 分 为 三 个 部 分 ， 中 间 是 本 应 用 和 功能 界面 的 名 称 或 者 提示 信息 ， 两 边 是 一 些 常用 的 界面 操作 按钮 ， 比 如 “退出 ”按钮 和 “后 


E: 


2. 中 部 内 容 框 


这 部 分 是 当前 功能 界面 的 具体 内 容 ， 一 般 根据 每 个 界面 的 功能 特征 而 有 所 不 同 ， 就 微 博 列表 界面 来 说 ， 此 部 分 就 是 由 用 户 所 关注 的 微 博信 息 列表 所 构成 的 。 


3. 底 部 频道 栏 


主要 功能 的 选择 框 ， 从 这 里 我 们 可 以 打开 其 他 功能 界面 进行 操作 ， 比 如 想 要 浏览 我 的 微 博 列表 ， 


我 们 会 发 现 这 种 类 型 的 界面 布局 的 特点 ， 其 实 除了 中 间 部 分 的 内 容 ， 项 部 和 底部 的 两 个 部 分 都 是 可 以 公用 的 
应 用 界面 的 开发 ， 其 实在 本 微 博 应 用 中 我 们 正 是 这 样 做 的 。 就 拿 微 博 列表 界面 来 说 ， 从 该 界面 的 XML 模 板 代码 (如 代码 清单 5-10 所 示 ) 中 ， 我 们 可 以 看 到 ， 虽 然 该 界面 的 布局 比较 复杂 ， 但 是 所 用 的 代码 却 


并 不 多 ; 从 这 里 我 们 也 能 看 出 ， 对 于 界面 模板 来 说 ， 使 用 一 些 “ 封 装 ”技巧 也 是 很 有 用 的 。 


代码 清单 5-10 


<?xml version="1.0" encoding="utf-8"?> 
«merge xmlns:android="http: //schemas.android.com/apk/res/android"> 
<include layout="@layout/main_layout" /> 
<LinearLayout android:orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
<include layout="@layout/main_top" /> 
<LinearLayout android:orientation-"vertical" 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android: layout_weight="1"> 
<ListView android:id-"G(*id/app index list view" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:descendantFocusability-"blocksDescendants" 
android: fadingEdge="vertical" android:fadingEdgeLength-"5dip" 
android: divider="@null" android: cacheColorHint="#00000000" 
android: listSelector="@drawable/xml_list_bg" /> 
</LinearLayout> = = 
<include layout="@layout/main_tab" /> 
</LinearLayout> T 
</merge> 


则 可 点 击 “Home” 选 项 ; 如 果 需 要 做 一 些 功能 配置 ， 则 可 点 击 对 应 的 按钮 进入 “用 户 配 置 ” 界 面 。 


因此 我 们 在 设计 界面 框架 时 就 会 考虑 能 不 能 把 这 些 公 用 的 部 分 提取 出 来 ， 从 而 规范 和 简化 


在 上 述 代码 中 ， 我 们 可 以 看 到 在 Android 模 板 中 可 以 使 用 include 标 签 来 包含 其 他 的 模板 ， 这 个 


法 和 Smarty 有 点 像 ， 这 里 顶部 和 底部 的 模板 分 别 


是 “@layout/main top” 和 “@layout/main_tab” 对 应 的 模板 文件 ， 即 res/layout 目 录 下 的 main_top.xml 和 main_tab.xml 文 件 ， 关 于 此 功能 模板 的 详细 内 容 我 会 在 7.7 节 中 给 大 家 详细 介绍 。 


实际 上 ， 在 本 书 的 微 博 实例 中 ， 除 了 “登录 界面 ”之 外 的 大 部 分 界面 都 采用 的 是 以 上 的 界面 结构 


， 因 此 建立 一 个 比较 合理 的 界面 框架 是 非常 有 意义 的 ， 大 家 可 以 想象 如 果 我 们 为 每 个 界面 都 去 写 项 部 和 


底部 的 界面 代码 需要 浪费 多 少 的 时 间 和 精力 。 由 于 篇 幅 的 限制 ， 我 们 不 在 这 里 讨论 模板 XML 代码 的 纪 
行 合理 的 组 合 从 而 快速 地 构造 出 整个 应 用 的 外 观 。 


5.3.2 主要 界面 设计 


节 ， 但 是 我 希望 通过 本 节 给 大 家 传递 一 个 理念 ， 那 就 是 对 于 Android 应 用 的 模板 来 说， 我 们 应 该 如 何 进 


前 面 我 们 在 介绍 微 博 应 用 界面 时 使 用 的 都 是 原型 草图 ， 但 是 若 要 用 于 开发 仅仅 使 用 界面 原型 草图 还 是 不 够 的 ， 一 般 来 说 我 们 在 开发 应 用 之 前 还 需要 将 原型 草图 转化 成 更 接近 于 实际 应 用 的 原型 图 才 可 。 


下 面 我 们 就 根据 微 博 应 用 的 功能 模块 将 几 个 最 重要 的 界面 原型 图 给 大 家 介绍 一 下 。 


= 


.用 户 登录 界面 


户 打开 微 博 应 用 所 看 到 的 第 一 个 界面 就 是 “用 户 登录 ”界面 ， 如 图 5-12 所 示 ， 此 界面 大 家 应 该 比较 熟悉 了 ， 因 为 我 们 在 之 前 介绍 原型 设计 时 就 是 拿 这 个 界面 作 例子 的 ， 至 于 此 界面 的 功能 我 们 就 不 元 


述 了 。 这 里 大 家 可 以 把 图 5-12 所 示 的 原型 界面 和 之 前 的 原型 草图 进行 对 比 ， 可 以 很 明显 地 看 到 此 原型 


图 比 之 前 的 草图 更 接近 于 应 用 的 实际 界面 ， 我 们 在 开发 时 会 先 对 此 原型 图 进行 “图 片 切割 ” ， 然 后 将 处 


理 好 的 图 片 存 放 在 Android 应 用 项 目的 res/drawable 目 录 下 ， 供 Android 的 XML 模板 文件 使 用 。 


@ 上 11:07 


* 8 * 8 ü 


记 住 密码 


图 5-12 用 户 登 录 界 面 


小 贴 士 : “切割 界面 ”一 般 使 用 Photoshop 图 片 处 理 软件 来 完成 ， 具 体 的 制作 方法 本 书 不 做 详细 介绍 ， 大 家 可 以 到 网 上 搜寻 相关 的 内 容 进行 学 习 。 


2. 微 博 列表 界面 


用 户 成 功 登录 之 后 就 会 看 到 “ 微 博 列表 界面 ”， 此 界面 应 该 可 以 算是 微 博 应 用 最 核心 的 功能 界面 了 ， 在 新 浪 微 博 中 此 界面 显示 的 是 所 有 关注 人 的 微 博信 息 ， 而 本 应 用 为 了 简化 功能 会 将 所 有 人 发 的 博客 


B6zs 
都 放 到 此 界面 中 ， 在 第 7 章 中 将 详细 介绍 。 这 里 我 们 主要 来 看 看 此 界面 的 布局 ， 如 图 5-13 所 示 ， 我 们 可 以 看 到 微 博信 息 列表 是 由 多 个 微 博 信息 构成 的 ， 每 个 微 博 信息 左边 是 用 户 的 头像 ， 右 边 则 是 微 博 的 信 


息 内 容 。 此 界面 我 们 在 前 面 也 给 大 家 介绍 过 ， 其 布局 可 以 作为 微 博 应 用 其 他 界面 的 典范 ， 另 外， 大 家 可 以 关注 一 下 界面 下 方 的 四 个 功能 按钮 ， 从 左 到 右 分 别 是 “ 微 博 列表 ”、 “我 的 微 博 列表 ”、“ 用 户 设 
置 ” 和 “撰写 微 博 ”四 大 功能 界面 的 入 口 ， 大 家 可 以 根据 需要 点 击 进入 对 应 的 功能 界面 。 


3. 微 博 正 文 界面 


当 我 们 点 击 单条 微 博 信息 时 ， 即 可 进入 “ 微 博 正文 界面 ”， 如 图 5-14 所 示 。 此 界面 中 部 内 容 比 较 丰 富 
中 比较 重要 的 一 个 界面 ， 相 关 的 具体 内 容 我 们 会 在 第 7 章 中 做 详细 介绍 。 


， 上 方 是 微 博 作者 的 具体 信息 ， 中 间 是 微 博 正文 ， 下 方 则 是 微 博 评论 的 信息 ， 此 界面 也 是 微 博 应 用 
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图 5-14 ft PEE SCR 
4 我 的 微 博 列表 界面 


当 我 们 点 击 界面 下 方 第 二 个 类 似 于 心 形 的 功能 按钮 时 ， 便 可 打开 “我 的 微 博 列表 界面 ”， 如 图 5-15 所 示 ， 此 界面 和 前 面 介 绍 的 “ 微 博 列表 界面 ”比较 类 似 ， 展 示 的 都 是 微 博 列表 的 内 容 ， 只 不 过 此 界面 
的 微 博 都 是 用 户 自己 所 发 的 ， 另 外 项 部 还 多 了 用 户 个 人 的 详细 信息 而 已 。 


5. 用 户 配置 界面 


当然 ， 一 个 比较 完整 的 应 用 是 不 能 缺少 “配置 界面 ”的 ， 当 用 户 点 击 下 方 的 第 三 个 爪子 型 的 按钮 时 ， 便 可 进入 微 博 应 用 的 “用 户 配 置 界 面 ”， 此 界面 也 比较 简单 ， 目 前 暂时 只 有 “更 换 头像 ”和 “修改 
签名 ”两 个 功能 。 这 里 我 们 需要 知道 的 是 ， 在 商业 版 的 微 博 应 用 中 ，“ 用 户 配置 界面 ” 绝 不 仅仅 只 有 这 些 功能 ， 但 是 由 于 本 应 用 主要 目的 仅 供 教学 所 用 ， 所 以 这 里 仅 实现 了 最 常见 的 两 个 功能 ; 当然 如 果 大 
家 能 够 掌握 本 书 实例 的 开发 方法 与 技巧 的 话 ， 完 全 可 以 基于 本 书 实例 框架 来 实现 一 个 完整 的 微 博 应 用 。 
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实例 和 普通 书本 的 实例 完全 不 同 ， 可 以 说 如 果 能 把 本 书 的 实例 代码 完全 掌握 下 来 ， 再 进行 一 些 轻微 的 定制 修改 ， 完 全 可 以 将 此 实例 作为 另外 一 个 Android 移 动 互联 网 应 用 的 基础 框架 来 使 用 。 


图 5-16 ”用户 配置 界面 


通过 对 以 上 几 个 主要 界面 的 介绍 ， 我 们 可 以 比较 清晰 地 看 出 微 博 实例 的 最 终 效 果 ， 大 家 可 以 结合 之 前 我 们 学 过 的 Android UI 制作 的 知识 来 思考 一 下 ， 如 果 美工 已 经 把 这 些 界面 的 效果 图 制作 完毕 ， 接 下 


户 端 开发 人 员 的 我 们 需要 怎么 做 呢 ? 当 然 ， 如 果 你 还 是 觉得 没有 头绪 的 话 也 没关系 ,我 们 将 在 7.2.1 节 中 详细 讲解 UI 实现 过 程 。 


此 外 ， 我 们 还 可 以 看 到 ， 本 书 微 博 实例 的 界面 设计 得 还 是 相当 精细 的 。 从 整体 的 艺术 风格 ， 到 细节 的 界面 边框 ， 


5A Wes 


解 。 


本 章 主要 讲述 了 程序 基础 框架 设计 的 内 容 ， 实 际 上 也 属于 实例 代码 开发 的 一 部 分 。 学 好 本 章 的 内 容 是 非常 重要 的 


实际 上 ，5.1 节 是 第 6 章 的 基础 ，5.2 节 和 5.3 节 则 是 第 7 章 的 基础 ， 大 家 可 以 根据 需要 来 进行 针对 性 的 


甚至 图 标 背景 等 ， 都 经 过 精心 的 设计 和 制作 ;我 们 从 这 个 侧面 也 可 以 看 出 ， 本 书 的 项 目 


为 我 们 对 本 书 实例 程序 开发 的 学 习 效 果 ， 很 大 程度 上 取决 于 对 应 用 基础 框架 的 理 


回 


顾 复习 。 大 家 有 了 这 个 概念 之 后 ， 就 算 以 后 分 析 实例 代码 时 碰 到 关于 架构 方面 的 疑问 ， 也 可 以 快速 


地 找到 对 应 的 内 容 进行 查阅 。 希 望 大 家 在 读 完 本 章 之 后 能 对 微 博 实例 的 整体 框架 有 更 深入 的 理解 ， 在 学 习 


第 6 章 服务 端 开发 


点 介绍 的 是 微 博 服务 端 接口 代码 的 逻辑 。 服 务 端 主要 负责 微 博 应 用 的 逻辑 处 理 和 数据 存储 的 核心 功能 ， 其 


PH 


接着 ， 在 第 5 章 中 介绍 了 实例 服务 端 程序 基础 框架 的 使 


后 面 章节 内 


在 第 5 章 中 ， 我 们 已 经 把 微 博 实例 应 用 的 基础 框架 搭建 完毕 ， 也 给 大 家 介绍 了 服务 端 和 客户 端 框 架 的 基本 概念 和 


容 的 时 候 会 更 加 顺利 。 


要 类 库 ， 接 下 来 的 两 章 内 容 将 对 微 博 实例 的 功能 逻辑 代码 实现 进行 讲解 。 其 中 ， 本 章 重 


看 要 性 不 言 而 喻 。 当 然 对 于 读者 来 阅 ， 最 重要 的 还 是 通过 对 本 实例 代码 的 学 习 和 理解 ， 掌 握 使 


P 语 言 进行 服务 端 开发 的 知识 和 技巧 。 


在 进入 正题 之 前 ， 我 们 先 来 回顾 一 下 之 前 我 们 介绍 的 关于 PHP 服 务 端 开 发 的 内 容 。 首 先 ， 在 第 3 章 中 给 大 家 介绍 了 PHP 语 言 的 编程 基础 ; 然后 ， 在 第 4 章 中 介绍 了 微 博 实例 的 整体 设计 以 及 数据 库 设计 ; 


我 建议 大 家 返回 对 应 的 章节 进行 复习 ， 把 基础 打 好 是 非常 必要 的 。 


61 开发 入 门 


Hush Framework 这 个 MVC 框 架 来 进行 互联 网 应 F 


这 里 所 说 的 “开发 入 门 ” 实 际 上 包含 两 层 意思 ， 一 是 “PHP 语 言 开发 入 门 ”， 另 一 个 则 是 “PHP 的 MVC 开 发 入 门 ”。 前 面 我 们 已 经 介绍 了 很 多 PHP 开 发 的 基础 知识 和 编程 技巧 ， 也 讲 了 很 多 如 何 使 
开发 的 思路 ; 但 是 仅仅 依靠 这 些 知识 ， 要 想 达 到 入 门 的 程度 可 能 还 不 够 。 何 为 “入 门 ”? 我 认为 至 少 要 懂得 如 何 运 用 所 学 的 知识 来 实现 简单 的 功能 模块 的 


逻辑 才 可 算得 上 是 “ 初 宕 门 径 ”。 


6.1 


， 为 我 们 进一步 学 习 微 博 实例 的 代码 打下 了 基础 。 实 际 上 ， 若 想 学 好 服务 端的 实例 代码 ， 以 上 的 内 容 都 是 必需 的 ; 如 果 觉 得 自己 没有 掌握 这 些 知识 ， 


当然 想 要 学 以 致 用 本 身 就 是 一 件 比较 困难 的 事情 ， 不 仅 要 有 理论 知识 作为 基础 ， 还 要 通过 动手 实践 才能 慢 慢 掌握 ; 本 书 的 实例 代码 就 给 大 家 提供 了 一 个 很 好 的 “学 习 和 实践 ”的 环境 ， 下 面 我 们 将 把 功 
能 模块 的 接口 逐个 详细 讲解 一 遍 ， 希 望 大 家 能 从 这 些 逻辑 代码 中 找到 PHP 程 序 开发 的 思路 和 感觉 。 


1 接口 程序 开发 


Rl 


来 写 逻 辑 就 可 以 了 。 我 们 已 经 知道 了 ， 微 博 应 用 框架 的 AP 接口 逻辑 都 被 存放 在 lib/Demos/App/Server 


分 的 运行 原理 我 们 可 以 参考 5.1.1 节 的 内 容 ， 这 里 就 不 做 深入 讨论 了 ; 这 里 我 们 需要 学 习 的 内 容 是 如 何 使 


和 面 我 们 已 经 对 微 博 应 用 的 服务 端 框架 做 过 很 多 分 析 和 讲解 ， 但 是 这 些 都 只 是 为 了 让 大 家 能 够 更 好 地 理解 整个 应 


录 下 的 控制 


现 有 的 框架 进 


运行 的 原理 。 实 际 上 ， 
器 类 里 ， 而 控制 器 类 里 


对 于 真正 的 接口 开发 工作 来 说 ， 只 需要 关注 如 何 按照 框架 规范 


面 的 每 个 Action 方 法 都 是 和 接口 URL 路 径 一 一 对 应 的 ， 关 于 这 部 


行 开发 。 接 下 来 ， 我 们 将 用 一 个 实例 来 说 明 这 点 。 


假设 我 们 现在 需要 实现 一 个 URL 地 址 为 “http://127.0.0.1: 8001/test/index” 的 API 接 口 ， 并 使 其 提供 一 个 服务 ， 这 个 服务 很 简单 ， 就 是 打印 出 一 行 字 : “My First Api”。 那 么 接 下 来 要 怎么 做 呢 ? 


其 实 很 简单 ， 按 照 之 前 我 们 在 5.1.1 节 中 学 习 过 的 服务 端 框 架 的 核心 映射 规则 来 思考 ， 只 需要 在 实例 项 目 


i= 
清和 


6-1 中 的 代码 。 


代码 清单 6-1 


"nz 

* Demos App 

* 

* @category Demos 

* @package Demos App Server 

* Qauthor James.Huang <huangjuanshi@163.com> 

* @license http: //www.apache.org/licenses/LICENSE-2.0 
* 


@version $Id$ 


ud 


require once 'Demos/App/Server.php'; 

** 

* (package Demos App Server 

* 

Class TestServer extends Demos App Server 


* > 全 局 设置 : 
* <code> 
* </code> 


的 控制 器 类 库 目 录 lib/Demos/App/Server 下 建立 一 个 名 为 “Testserver.php” 的 文件 ， 并 输入 代码 


PN wii 
public function  : 
{ 


parent:: init(); 


Š 
HB M MM LU P P P B I H P fii 
// 服务 端 API 方 法 


/ 


* 


> 接口 说 明 : 测试 接口 
<code> 

URL 地 址 : /test/index 
提交 方式 : POST 
</code> 


* 
* 
* 
* 
* 


+ * 


@title 测试 接口 
@action /test/index 
@method get 


* * 


ud 
public function indexAction () 
{ 
echo "My First Api"; 
} 


接着 ,运行 Xampp 开 发 环境 套件 中 的 Apache 服 务 器 组 件 ， 我 们 便 可 以 在 浏览 器 中 打开 TestServer 控 制 器 对 应 的 接 


Cry 


eL 


127.0.0.1 


€ 


My First Api 


图 6-1 


分 析 过 TestServer 控 制 器 类 的 代码 之 后 我 们 可 以 发 现 ， 其 实 代码 中 与 API 接 
已 。 至 于 运行 效果 我 们 已 经 在 浏览 器 中 看 到 了 。 


代码 清单 6-2 


地 址 (http://127.0.0.1: 8001/test/index) 进行 查看 ， 运 行 效果 如 


6-1 所 示 。 


TestServer 控 制 器 界面 


逻辑 有 关 的 只 有 以 下 几 行 代码 ( 见 代 码 清单 6-2) ， 相 关 代 码 罗 辑 其 实 非 常 简单 ， 就 是 打印 出 “My First Api” 这 句 话 而 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompr: 
public function indexAction () 
{ 
echo "My First Api"; 


} 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompr: 


实际 上 ，TestServer 控 制 器 类 代码 中 更 需要 引起 我 们 注意 | 
一 下 ， 除 了 给 代码 注解 的 功能 之 外 ， 注 释 代 码 还 有 哪些 “ 妙 


代码 清单 “6-3 


的 是 以 下 这 段 注 释 代 码 ， 如 代码 清和 


essed/15327/OEBPS/Text/... 


essed/15327/OEBPS/Text/... 


6-3 所 示 ， 也 许 我 们 之 前 一 直 没 有 注意 过 “注释 语句 ”在 程序 开发 中 的 作用 ， 这 里 我 们 正好 趁 这 个 机 会 了 解 


http://waw.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompr: 
/** 


* 


> 接口 说 明 : 测试 接口 
<code> 

URL 地 址 : /test/index 
提交 方式 : POST 
</code> 

Qtitle 测试 接口 
@action /test/index 
@method get 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompr: 


essed/15327/OEBPS/Text/... 


essed/15327/OEBPS/Text/... 


我 们 看 到 以 上 的 注释 代码 分 为 两 个 部 分 : 上 半 部 分 的 文字 主要 是 对 这 个 接口 基本 信息 的 说 明 ， 可 以 被 “文档 生成 工具 ” 读 取 ， 用 做 该 接口 的 使 用 说 明 ， 而 “<code> ”标签 中 的 内 容 可 以 是 PHP 的 示例 
代码 。 下 半 部 分 的 以 “@ ”字符 开头 的 注释 则 是 给 “调试 后 台 ” 中 对 应 的 接口 测试 工具 使 用 的 ， 以 下 我 们 来 逐个 解释 。 


: @title: 对 应 调试 后 台中 API 接 口 名 ( 即 tite) 信息 。 
-@action: 对 应 调试 后 台中 API 接 口 的 URL 路 径 ， 即 action 信 息 。 


- @method: 对 应 调试 后 台中 模拟 接口 访问 工具 所 使 用 的 HTTP 访 问 方法 (get 或 post) 


在 本 应 


框架 中 ， 只 要 在 接口 代码 中 标注 了 以 上 注释 语句 ， 那 么 在 “调试 
以 上 注释 的 对 应 信息 ， 例 如 ， 这 里 的 接口 名 (title) 为 “测试 接 


后 台 ” 中 便 会 


们 就 可 以 看 到 


自动 生成 该 接 [ 
”， 对 应 的 就 是 注释 @title 的 值 ; SA, A 


对 应 的 测试 界面 。 比 如 ， 


6-2 所 示 的 是 以 上 测试 接口 
[0 果 我 们 修改 某 个 注释 的 值 ， 也 会 立即 


(TestServer) 对 应 的 测试 界面 。 在 这 里 我 
映 到 测试 界面 上 (可 刷新 页 面 后 查看 ) 。 


€) 


127.0.0.1:8001/debug/apiTes 


bu. 


Demos Debug Server - v1.0 


Home | Api Test | Api Stat | Logout 


TestServer » indexAction 


title 


action 


测试 接口 


method 


Test 


Submit 
My First Api 


Test Result 


至 此 ， 我 们 通过 对 一 个 测试 接口 TestServer 的 开发 ， 给 大 家 讲解 了 服务 端 API 接 口 的 开发 以 及 部 分 调试 过 程 ， 我 们 可 以 发 现 使 有 
的 事情 ， 接 下 来 在 本 章 中 我 们 还 会 通过 对 微 博 实例 的 所 有 服务 端 接口 的 逐个 介绍 来 深化 大 家 对 于 使 用 PHP 进 行 移动 互联 网 应 用 的 服务 端 开发 的 认识 。 


这 么 做 的 好 处 也 是 显而易见 的 ， 我 们 只 需要 设置 几 个 注释 代码 就 可 以 很 方便 地 通过 接口 测试 工具 来 调试 API 接 


图 6-2 ”注释 语句 对 照 界 面 


/test/index?sid=27ru47hrob7jcbupab55edmu1m2ogl5g8 


IR" 也 学 会 Li 


6.1.2 ”调试 框架 开发 


本 书 实例 所 带 的 PHP 服 务 端 开发 框架 来 进行 接口 开发 是 一 件 多 么 轻松 愉快 


了 ， 大 大 提高 了 服务 端 API 接 口 的 开发 效率 ; 当然 ， 如 果 你 把 本 应 用 框架 中 的 “文档 生成 


并 用 其 将 这 些 注释 语句 转化 成 了 规范 而 美观 的 API 接 口 文 档 时 (生成 文档 的 相关 内 容 见 本 章 6.1.3 节 ) ， 也 许 你 会 由 衷 感叹 “原来 注释 语句 也 可 以 如 此 妙用 无 穷 啊 ”。 


关于 调试 框架 的 使 用 ， 我 们 之 前 已 经 介绍 很 多 了 ， 本 节 主 要 是 分 析 调试 框架 核心 功能 的 代码 实现 ， 让 大 家 能 够 更 好 地 理解 这 部 分 的 内 容 。 我 们 知道 ， 除 了 “登录 界面 ”之 外 ， 调 试 框架 中 最 核心 的 两 个 
功能 界面 分 别 是 “测试 接口 列表 ”和 “接口 测试 工具 ”。 


1 .测试 接 


列表 


此 界面 的 逻辑 是 根据 API 接 口 的 控制 器 类 代码 中 的 注释 代码 自动 地 罗列 出 所 有 可 用 的 接口 列表 ， 以 供 我 们 选择 调试 。 在 6.1.1 节 中 我 们 已 经 简单 介绍 了 API 接 口 程序 中 的 注释 代码 的 用 法 ， 而 这 里 我 们 将 对 
调试 框架 的 逻辑 代码 进行 讲解 ， 搞 清楚 调试 框架 是 如 何 自动 读 取 并 列 出 所 有 接口 信息 的 ， 调 试 框架 对 应 控制 器 类 Debugserver 的 代码 如 代码 清单 6-4 所 示 。 


代码 清单 


6-4 


// 对 应 “/debug/” 路 径 的 控制 器 类 
class DebugServer extends Demos_App Server 


{ 


// 页 面 初始 化 
public function _ init () 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


// 在 页 面 初始 化 的 时 候 获取 API 接口 列表 
$this-»serviceConfigList = $this->_getServiceConfigList () 7 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 测试 接口 列表 展示 
public function apiListAction () 


{ 


} 


Sthis-»doAuthAdmin(); 

$this-» printMenu(); 

$html = "<table class-'tbfix' cellpadding=1 cellspacing=1>\n"; 

foreach ((array) $this->serviceConfigList as $serviceName => SactionList) { 


$html .= "<tr><td class-'title' colspan=4>{$serviceName}</td></tr>\n"; 
foreach ((array) $actionList as $actionName => $actionConfig) { 
$html .= "<tr><td>{$actionName}</td><td>{$actionConfig['title'] 


}</td><td>{$actionConfig['action'] }</td><td><a href-'apiTest? 
serviceName={$serviceName} &actionName={$actionName} '>ill] it</a> 
</td></tr>\n"; 

š 


} 
$html .= "</table>Nn"; 
echo $html; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 获取 API 接口 信息 列表 
protected function _getServiceConfigList () 


{ 


require once 'Hush/Document.php'; 


$serviceConfiglist = array(); 
foreach (glob( LIB PATH SERVER . '/*.php') as $classFile) { 
$className = basename($classFile, '.php'); 
if ($classFile && $className) { 
require once $classFile; 
$rClass = new Ref 
$methodList = $rC 
$doc = new Hush Document ($classFile); 
foreach ($methodList as $method) ( 
$config = $doc-»getAnnotation ($className, $method->name) ; 
if ($config && preg match('/Action$/', S$method-»name)) ( 


} 
} 


$serviceCol 


} 


return $serviceConfigList; 


lectionClass ($className) ; 
‘lass—>getMethods () ; 


nfigList [$className] [$method->name] = $config; 


我 们 从 上 面 的 代码 可 以 看 出 ， 与 测试 接口 


(1) _init 页 面 初始 化 方法 


列表 页 面 有 关系 的 方法 有 以 下 三 个 。 


此 方法 也 是 所 有 控制 器 类 的 初始 化 方法 ， 只 做 了 一 件 事 ， 那 就 是 把 getServiceConfigList 方 法 的 结果 赋值 给 了 数组 变量 serviceConfigList， 实 际 上 在 这 个 地 方 我 们 已 经 获取 了 所 有 的 接口 信息 。 


(2) apiListAction 方 法 


此 方法 对 应 的 是 “测试 接口 列表 ”的 Action 逻 辑 ， 我 们 可 以 看 到 这 里 的 逻辑 比较 简单 ， 先 在 最 前 面 使 
了 一 遍 ， 并 把 所 有 接口 信息 组 合成 HTML 语 名 打印 出 来 。 这 里 并 没有 使 用 Smarty 来 写 PHP 模 板 ， 因 为 调试 后 台 的 界面 比较 简 和 


(3) getServiceConfigList75; 


doAuthAdmin 方 法 判断 了 一 下 是 否 登录 ， 然 后 就 是 把 之 前 准备 好 的 serviceConfigList 数 组 遍历 


E， 当 然 如 果 你 觉得 使 用 Smarty 更 好 ， 可 以 自己 写 模板 然后 使 用 render 方 法 泻 


这 个 方法 用 于 取得 所 有 接口 信息 ， 逻 辑 相对 比较 复杂 ， 我 们 来 重点 分 析 一 下 。 首 先 ， 程 序 使 用 glob 方 法 把 _LIB_PATH_SERVER， 也 就 是 控制 器 类 库 目录 下 面 的 所 有 PHP 文 件 全 部 取出 来 ; 然后 ， 我 们 使 


变量 $serviceConfigList 中 并 返回 


小 贴 士 : 在 代码 设计 时 ， 我 们 经 常 使 用 “反射 类 ”来 操 


档 。 


2. 接 口 测试 工 


了 榨 一 个 类 的 各 个 组 件 ， 比 如 类 属性 、 方 法 等 。 这 个 语言 特性 在 Java 和 PHP 语 


PHP 的 “反射 类 ” (Reflection Class) 把 每 个 控制 器 里 面 的 方法 名 获取 出 来 ;最 后 ， 我 们 使 用 Hush Framework 中 的 Hush_Document 类 库 来 解析 各 个 Action 方 法 的 注释 代码 ， 并 将 这 些 信息 保存 到 数组 
。 而 实际 上 由 此 方法 处 理 好 的 信息 又 经 由 _init 方 法 中 的 serviceConfigList 变 量 被 传递 到 apiListAction 方 法 中 使 用 ， 最 终 转 化 成 HTML 代 码 展示 到 浏览 器 上 。 


中 均 存 在 ， 关 于 PHP 中 反射 类 使 用 的 更 多 信息 大 家 可 以 参考 PHP 文 


从 “测试 接口 列表 ”中 选择 需 
Action 的 逻辑 同样 也 在 控制 器 类 DebugServer 里 夯 


代码 清单 6-5 


要 模拟 调试 的 接 [ 


， 下 面 我 们 把 这 个 部 分 的 代码 摘录 出 来 供 大 家 学 习 ， 见 代码 清单 6-5。 


， 并 单 击 右 侧 的 “测试 ”链接 就 可 以 进入 对 应 的 “接口 测试 工具 ”界面 来 调试 此 API 接 口 ， 此 界面 大 家 应 该 比较 熟悉 了 ， 如 图 6-2 所 示 。 而 接口 测试 工具 


class DebugServer extends Demos_App Server 


{ 
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// 接口 测试 工具 展示 逻辑 
public function apiTestAction () 


{ 


Sthis-»doAuthAdmin(); 

Sthis-» printMenu(); 

// 准备 测试 工具 的 JavaScript 方 法 
echo "<script type='text/javascript' src='/js/debug/apiTest.js'></script>Nn"; 
echo "<script type='text/javascript'>\n"; 

echo "$ (document) . ready (function () ("; 

echo "var header={};"; 
echo "$('.doTest') .click (function () (apiTest (header) }) ;"; 


echo "});\n"; 


echo "</script>\n"; 


// 获取 接口 信息 


$serviceName 


Sthis-»param(' 


serviceName'); 


SactionName = $this->param('actionName') ; 
$configList = $this->serviceConfigList [$serviceName] |$actionName]; 
if (!$configList) { 

echo "Error : can not f 


exit; 


l 

// 给 API 接 口 地 址 加 上 Session ID 
$configList['action'] = $this->url->format ($configList ['action']); 
// 测试 工具 界面 展示 
$action = $configList['action']; 

Smethod = $configList['method"]; 

Shtml = "<input type='hidden' id='action' value='(Saction)'/>Nn"; 


$html 
$html 
$html 


ound '$serviceName: :$actionName' .\n"; 


"<input type-'hidden' id='method' value='{$method}'/>\n"; 
"<table class='tbcom' cellpadding=1 cellspacing=1>\n"; 
"<tr><td class='title' colspan=2>($serviceName) > {$actionName}</td></tr>\n"; 


foreach ((array) $configList as $configKey => $configVal) { 
// 接口 参数 信息 (数组 ) 
if (is array($configVal)) { 
Shtml .= "<tr><td>Test Data</td><td><table>\n"; 
foreach ((array) $configVal as $paramName => SparamData) { 


SparamDval 
SparamDesc 
$html .= " 


= $paramData['dval']; // default value 
= $paramData['desc']; // description 
<tr><td>KEY : «input type-'text' 


name-'paramKey' value='{$paramName}'/> VALUE : <input 


type-'text' 
value-'$pari 
} 
$html .= "</table: 
// 普通 接口 信息 
) else { 
$html .= "<tr>< 


} 
l 


name-'paramVal' style-'width:300px' 
amDval'/» ({$paramDesc}) </td></tr>\n"; 


></td></tr>\n"; 


td class-'left'»(SconfigKey] 


</td><td>{$configVal}</td></tr>\n"; 


$html .= "<tr><td class-'left'»Test Submit</td><td><input type-'button' 
class-'doTest'value-'4t € il iK'/></td></tr>\n"; 

$html .= "<tr><td class='left'>Test Result</td><td><textarea 
id='result'></textarea></td></tr>\n"; 

Shtml .= "</table>\n"; 


echo $html; 
} 
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从 上 面 的 代码 可 以 看 出 ， 此 方法 涉及 的 逻辑 相对 比较 多 一 些 。 建 议 大 家 先 参考 以 上 代码 中 的 注释 ， 独 立 阅读 并 理解 一 下 此 方法 的 逻辑 ， 遇 到 问题 再 参考 下 面 我 们 提 到 的 几 个 难点 讲解 ， 这 样 有 助 于 提高 


自己 阅读 代码 的 能 


(1) 关于 JavaScript 方 法 


其 实 对 于 大 部 分 的 互联 网 应 


来 说 ， 想 要 脱离 JavaScript 是 一 件 不 大 可 能 的 对 


jQuery 类 库 ， 在 项 目 中 经 常会 用 到 


Result” 右 侧 的 输出 框 里 。 


小 贴 士 : 如 果 你 对 JavaScript 语 言 和 Ajax 概念 不 熟悉 ， 建 议 自学 ， 本 书 对 于 这 部 分 的 内 容 不 做 深究 ， 这 里 大 家 了 解 一 下 运行 原理 骨 


(2) 关于 接口 的 Session 


如 果 大 家 对 于 PHP 语 言 中 的 Session 会 话 的 概念 和 使 有 
Rit, Session 1D 都 是 通过 URL 传 递 的 ， 所 以 才 有 了 “$this->url->format ($configList['action']) ; ” 
从 DebugServer 的 基 类 Demos App_Server 中 查 到 “$this->url” 变 量 的 由 来 ， 其 实 就 是 Demos_Util_Url 对 象 的 实例 。 


(3) 关于 界面 展示 的 逻辑 


界面 展示 的 逻辑 比较 多 ， 但 是 大 部 分 的 逻辑 都 是 根 


PHP 编 程 技巧 的 理解 和 掌握 。 


。 本 接口 测试 工具 中 的 “提交 测试 ”动作 触发 的 是 一 个 Ajax 请 求 ， 简 和 


顾 本 书 3.1.5 节 的 内 容 。 微 博 应 


至 此 ,我 们 已 经 把 “调试 框架 ”最 重 


6.1.3 ”生成 接口 文档 


前 面 在 介绍 注释 代码 的 用 途 时 ， 曾 经 提 到 过 自动 生成 接口 
生成 的 AP 文档 会 被 保存 在 doc/doc-api 目 录 下 ， 我 们 在 浏览 器 中 打开 index.html 就 可 以 看 到 生成 好 的 API 接 | 


小 贴 士 : 如 果 命 令 执行 出 错 可 能 是 因为 我 们 没有 正确 安装 PhpDocumentor 类 库 ， 大 家 可 以 到 Hush Framework + 5t 49 Downloads f i T #Phpdoc.zi 
HJ COMM LIB DIR 3E X 3,05 € E E RTT. 


Sita EMO Ae 


x| 


SB. 当然 本 书 不 会 给 大 家 介绍 JavaScript 的 语法 ， 但 是 我 建议 大 家 可 以 去 了 解 一 些 JavaScript 脚 本 语言 的 方法 ， 特 别 是 
到 的 参数 提交 到 对 应 的 API 接 口 的 URL 中 去 ， 并 把 返回 展示 在 “Test 


RRA, CANE 


文档 的 功能 ， 实 际 上 在 本 框架 中 自 带 了 生成 API 接 


口 都 是 要 求 用 户 登 录 的 ， 所 以 就 必须 要 用 到 Session 会 话 的 功能 ， 对 于 API 接 口 
就 是 把 Session ID 通过 sid 参 数 附加 到 URL 地 址 中 来 进行 传递 。 另 外 ,我们 可 以 


写 HTML 语 句 ， 这 里 就 不 做 详细 解释 了 ， 如 果 有 兴趣 可 以 尝试 使 用 Smarty 模 板 来 实现 这 里 的 界面 展示 ， 这 样 会 更 有 利于 对 


面 和 逻辑 介绍 完了 ， 至 于 其 中 的 一 些 逻 辑 细节 还 需要 大 家 通过 阅读 实例 代码 来 慢 慢 体 会 和 掌握 ;但 是 到 这 个 时 候 ， 我 要 求 大 家 至 少 必 须 懂得 如 何 使 
“调试 框架 ”来 进行 API 接 口 的 调试 和 开发 。 另 外 ， 希 望 大 家 动手 尝试 进行 一 些 简单 接口 逻辑 的 开发 。 


pe 


命令 行 工 


进入 实例 的 bin/ 目 录 并 执行 “cli doc build” 命 令 即 可 ， 


压缩 包 ， 然 后 再 解压 安装 到 与 etc/global.defines.php 文 件 中 


Demos_App_Server 


Description 
Class trees 
Index of elements 
@ Services 
a BlogServer 
I | ComnentServer 
ad CustomerServer 
a DebugServer 
a ImageServer 
Ul IndexServer 
al NotifyServer 


"Yer 


phpDocumentor v 1.4.3 


如 图 6-3 所 示 ，, 假 如 我 们 打开 TestServer 的 API 文 档 ， 就 可 以 看 到 之 前 我 们 所 写 的 “/test/index” 测 试 接 


现 两 者 确实 是 一 致 的 。 


实际 上 ， 在 项 目 中 API 接 口 文档 作为 技术 文档 的 一 个 必要 组 成 部 分 是 非常 和 
这 个 问题 ， 简 单 的 一 句 命 令 行 操作 ， 就 把 这 个 “麻烦 


6.2 ”验证 接口 


> 接口 说 明 : 测试 接口 


URL###F : / test/ index 


#E3225x( : POST 


a access: public 


void indexAction [) 
> init (line 26) 


图 6-3 ”生成 的 服务 端 文档 


目前 主流 的 网 络 应 用 都 离 不 开 


录 和 登 出 是 用 户 验证 功能 中 最 基本 的 


有 两 个 : 其 一 是 保护 注册 
当然 也 离 不 开 这 两 个 接口 


= 
ci 


han 


Description | Methods ( 


的 ， 但 是 通常 由 于 开发 时 间 


户 的 信息 安全 和 网 络 应 
， 接 着 我 们 来 逐个 分 析 。 在 


的 说 明 信 息 了 ; 大 家 可 以 把 这 里 的 信息 和 前 面 “ 代 码 清单 6-3” 中 的 注释 代码 比 对 一 下 ， 会 发 


比较 紧 ， 文 档 制作 成 本 又 比较 高 ， 所 以 准备 起 来 常常 非常 头疼 ; 而 本 实例 框架 却 帮助 我 们 解决 了 
”搞定 了 ， 确 实 非 常 高 效 ， 有 兴趣 的 读者 可 以 研究 一 下 lib/Demos/CIVDoc.php 中 的 代码 ， 看 看 本 实例 框架 是 如 何 做 到 这 一 点 的 。 


的 访问 安全 ; 其 二 是 便于 积累 有 效用 户 ， 进 而 建立 以 用 户 为 中 心 的 各 项 业务 。 用 户 登 
此 之 前 还 需要 了 解 的 是 ， 由 于 验证 接口 比较 独立 ， 不 大 好 归 类 ， 所 以 我 们 把 它们 都 放 到 


IndexServer 控 制 器 类 下 。 


6.2.1 用 户 登 录 接口 
户 登 录 接 口 是 微 博 应 用 的 总 入 口 ， 也 是 微 博 登 录 界 面 需要 请 求 的 接口 ， 该 接口 会 接收 
的 逻辑 并 不 复杂 ， 不 过 我 们 需要 注意 PHP 程 序 的 写法 ， 因 为 每 个 框架 都 有 自己 的 特色 ， 而 本 书 实例 所 采 


代码 逻辑 请 参考 代码 清单 6-6。 


代码 清单 


6-6 


class IndexServer extends Demos_App Server 


PZ (name) 和 密码 (pass) 两 个 参数 ， 然 后 到 数据 库 验证 用 户 是 否 存在 ， 并 将 结果 返回 给 客户 端 。 该 接口 


的 框架 也 不 例外 。 


户 登 录 接 口 


方法 位 于 PHP 文 件 lib/Demos/App/Server/IndexServer.php 中 ， 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
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> 接口 说 明 : 用 户 登 录 接 口 
<code> 


URL 地 址 : /index/login 


提交 方式 : POST 

参数 #1: name, KA: STRING， 必 
参数 #2: Pass， 类 型 : STRING， 必 
</code> 


Gtitle 用 户 登 录 接 口 

@action /index/login 
@params name james STRING 
@params pass james STRING 
@method post 


lic function loginAction () 


// RP ESSERE 

$name = $this-»param(' 

$pass = $this-»param(' 

if ($name && $pass) { 
$customerDao = $this->dao->load('Core_Customer') ; 
$customer = $customerDao->doAuth ($name, $pass); 
if (Scustomer) { 


name'); 
pass'); 


$customer['sid'] = session id(); 
$ SESSION['customer'] = $customer; 
Sthis-»render('10002', 'Login ok', array( 


'Customer' => $customer 


)); 
} 


} 

// 返回 SessionID 给 客户 端 

$customer = array('sid' => session id()); 

Šthis->render('14001', ‘Login failed', array( 
'Customer' => $customer 


) ) 7 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


首先 ， 我 们 需要 了 解 登录 接口 的 使 用 ，loginAction 接 口 方法 对 应 的 是 /index/login 的 接口 地 址 ， 该 接口 地 址 会 接受 从 客户 端的 登录 界面 发 来 的 请 求 ， 进 而 完成 服务 端的 登录 动作 。 实 际 上 ， 后 面 所 有 的 
服务 端 接口 都 是 这 样 使 用 的 。 
然后 ， 再 来 理解 一 下 loginAction 方 法 前 面 的 注释 代码 ， 其 实在 6.1.1 节 中 我 们 已 经 学 习 了 在 本 书 微 博 实例 的 服务 端 框架 下 进行 接口 开发 的 方法 ， 里 面 也 介绍 了 接口 注释 的 使 用 ， 结 合 登 录 接 口 的 实例 代码 


我 们 正好 可 以 进一步 地 理解 其 用 法 。 


E 


说 明 ” 部 分 是 自动 生成 文档 


接着 来 分 析 接口 代码 ， 我 们 将 按照 


逻辑 顺序 把 代码 中 重要 的 知识 点 介绍 一 下 。 首 先 使 


证 方法 进行 处 理 ， 如 果 验 证 成 功 就 把 


户 信息 放 入 Session 会 话 中， 并 且 返 回 


param 方 法 获得 传 入 的 | 
登录 成 功 ， 否 则 返回 


的 ， 而 后 面 的 @title、@action、@params 则 是 给 调试 后 台 用 的 。 


登录 失败 。doAuth 用 户 验 证 方法 的 逻辑 见 代码 清单 6-7。 


户 名 (name) 和 密码 (pass) 参数 ， 然 后 调 


户 验 


Core Customer 类 中 的 doAuth 


代码 清单 6-7 


class IndexServer extends Demos_App Server 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


/** 
* User login 

* @param string $user 
* @param string Spass 
*/ 


public function doAuth ($user, $pass) 


{ 


// 对 应 SQL: SELECT * FROM customer WHERE name=? and pass=? 


$sql = $this->select () 
->from($this->t1, 


—>where (" ($this->tl).name 
—>where ("($this->tl).pass 


tk!) 
?", Suser) 
2", Spass) ; 


$user = $this-—>dbr () ->fetchRow ($sql); 


if ($user) 
return false; 


return $user; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


doAuth 方 法 的 逻辑 不 复杂 ， 就 是 根据 


户 名 和 密码 到 数据 表 中 查找 


的 信息 ， 如 果 查 到 则 返回 


户 信息 ， 若 查 不 到 就 返回 false。 这 号 


我 们 要 特别 注意 的 是 该 方法 的 语法 ， 因 


为 该 方法 中 的 查询 代码 


是 实例 框架 DAO 类 中 标准 的 查询 语句 的 写法 ， 而 类 似 的 语法 在 微 博 实例 服务 端的 代码 中 还 会 经 常见 到 ， 大 家 可 以 结合 doAuth 方 法 代码 中 的 注释 进行 语义 理解 ， 如 果 对 这 个 地 方 有 疑问 ， 请 复习 一 下 3.6.4 节 


首先 ， 我 们 来 介绍 dbr 的 有 


Ez, 
查询 操作 ， 所 以 我 们 选择 使 


也 就 是 dbr 和 fetchRow 的 用 法 。 


功能 


中 关于 DAO 类 查询 方法 的 内 容 。 除 此 之 外 ， 这 里 还 要 介绍 另外 两 个 重点 ， 
法 。 我 们 需要 知道 的 是 ， 由 于 本 框架 是 支持 数据 库 “ 读 写 分 离 
主要 负责 查询 操作 。 由 于 大 部 分 的 网 络 应 用 查询 操作 远大 于 写 入 操作 ， 所 以 我 们 一 般 使 
db 方法 来 配合 执行 ; 当然 ， 如 果 是 写 库 操作 ， 则 需要 使 用 dbw 
“一 主 多 从 ”是 MySQL 数 据 库 比 较 流行 的 用 法 ， 主 库 负责 写 ， 从 库 负责 读 。 这 


小 贴 士 : 


然后 ， 我 们 来 介绍 一 下 fetchRow 的 上 
强大 的 查询 方法 。 


-fetchOne: 查找 单个 值 ， 一 般 使 用 


- fetchRow: 


法 。 实 际 上 ， 对 了 


查找 单行 ， 一 般 使 用 该 方法 进行 单行 的 查询 ， 比 如 查询 某 个 用 户 的 信息 。 


(db write 的 缩写 ) 方法 。 


用 法 比较 有 利于 分 散 读 库 操作 的 访问 压力 ， 所 


的 ， 所 以 就 有 了 “ 写 库 ”和 “ 读 库 ” 的 概念 。 
主 多 从 ”的 做 法 来 架构 数据 库 。dbr 其 实 是 db read 的 缩写 ， 代 表 的 操作 是 读 库 ， 由 于 doAuth 方 法 主要 是 


写 库 是 主 库 ， 主 要 负责 插入 、 更 新 数据 等 写 操作 ; 读 库 是 从 


以 经 常 被 “ 读 远 大 于 写 ” 的 各 种 Web 2.0 的 互联 网 应 用 所 采用 。 


Hush Framework 来 开发 的 微 博 实例 的 服务 端 框架 来 说 ， 除 了 最 基本 的 CRUD 方 法 ( 详 见 3.6.3 节 ) 中 的 read 方 法 之 外 ， 还 有 以 下 几 个 更 为 


该 方法 进行 单个 字段 的 查询 ， 比 如 查询 菜 个 用 户 的 用 户 名 字段 。 查 询 成 功 则 返回 该 字段 的 值 (默认 为 字符 串 ) ， 若 失败 则 返回 false。 


查询 成 功 则 返回 整 行 的 用 户 数据 (默认 为 一 维 数组 ) ， 若 失败 则 返回 fse。 


“fetchAll: 查找 所 有 行 ， 一 般 使 用 该 方法 进行 所 有 行 的 查询 ， 比 如 查询 某 些 用 户 的 信息 。 查 询 成 功 则 返回 多 行 的 用 户 数据 (默认 为 二 维 数 组 ) ， 若 失败 则 返回 false。 


由 于 doAuth 方 法 需要 查询 的 是 登录 用 户 的 基本 信息 ， 也 就 是 单行 的 用 户 数据 ， 所 以 在 这 里 我 们 使 用 的 是 fetchRow 方 法 ， 至 于 其 他 几 个 查询 方法 的 使 用 方法 ， 后 面 很 快 就 会 接触 到 。 在 loginAction 方 法 
逻辑 中 调用 doAuth 返 回 数据 时 ， 程 序 判断 是 否 成 功 得 到 用 户 基本 信息 ， 如 果 是 则 表示 用 户 名 和 密码 已 经 验证 通过 ， 这 时 我 们 就 把 用 户 信息 存放 到 Session 会 话 中 ， 供 其 他 接口 使 用 ;反之 则 返回 失败 信息 。 
我 们 可 以 在 调试 后 台 看 到 相应 的 结果 信息 ， 图 6-4 就 是 登录 成 功 返 回 结果 的 截图 。 


按照 之 前 4.6 节 所 述 的 消息 协议 的 设计 ， 登 录 接 口 的 真实 返回 如 代码 清单 6-8 所 示 。 我 们 简单 分 析 一 下 ，code 对 应 的 10000 数 字 代码 表示 的 是 正确 的 返回 ， 客 户 端 会 根据 这 个 值 来 分 辨 登录 是 否 成 功 ; 
message 表 示 的 是 返回 信息 ， 比 如 这 里 返回 的 就 是 “登录 成 功 ”信息 ; 而 result 则 相对 比较 复杂 一 点 ， 包 含 了 一 个 Customer 模 型 对 象 ， 该 对 象 包 含 了 用 户 的 基本 信息 和 Session 1D。 另 外 ， 这 个 模型 对 象 必 
须 和 客户 端的 模型 一 致 (客户 端 模 型 的 源码 可 参考 src 中 的 com.app.demos.model 包 下 的 Customer.java 文 件 ) ， 客 户 端 程序 接收 到 此 返回 之 后 ， 将 根据 返回 信息 做 相应 的 处 理 。 


€ &$ 127.00. :8201/debug/apiTest?cer vice vame=indexser verstactior @ c | B- x Ë @ ”会 è- I ie a ~ & m rh 
Demos Debug Server - v1.0 
Home | Api Test | Api Stat | Logout 
IndexServer > loginAction 
title 用 户 登 录 接 口 
action /index/login?sid=80am9iksbajqdgpal3cpa5pq8cf3m0ec& 
KEY : nane | VALUE : janes | (STRING) 
Test Data 
KEY : [pass | VALUE : janes | (STRING) 
method post 
Test Submit 
i ^ 
*code":" 10000", 
"message":"Login ok’, 
"result":[ 
"Customer"; 
"id":1, = 
Test Result ential james " 
sign"; Happying', 
"face"; 1", 
"blogcount":0, 
*fanscount":0, = 
ruptime":"2011-11-29 18:11:24", 
*sid":"80am9iksbajądgpa13cpa5pq8cf3m0ec" a 
} 


图 6-4 登录 成 功 返回 的 结果 


代码 清单 6-8 


"code":"10000", 

"message" :"Login ok", 

"result":( 
"Customer": { 


: , 
"blogcount":0, 
"fanscount":0, 
"uptime":"2011-12-29 16:08:04", 
"sid":"l11gnafhun4cqfgnlaljajll0dq5hik6k" 


相反 ， 如 果 我 们 输入 错误 的 用 户 各 或 者 密码 ， 那 么 返回 的 JSON 消 息 就 会 如 代码 清单 6-9 所 示 ， 大 家 可 以 对 照 代码 清单 6-8 来 分 析 和 理解 。 其 中 code 和 message 的 变化 比较 明显 ， 不 再 获 述 ; 不 过 需要 注 
意 的 是 result 中 仍然 返回 了 Customer 对 象 的 Session ID， 这 是 为 了 让 客户 端 能 记 下 来 ， 避 免 了 每 次 访问 都 产生 新 的 Session 会 话 ， 从 一 定 程度 上 减轻 了 服务 端的 负担 。 另 外 ， 更 多 服务 端 Session 优 化 的 内 容 
我 们 会 在 9.1.2 节 中 给 大 家 介绍 。 


代码 清单 6-9 


"code":"10003", 
"message" :"Login failed", 
"result":{ 
"Customer":{ 
"sid":"1llgnafhun4cqfgnlaljajll0dq5hik6k" 
} 


另外 ， 这 里 还 需要 注意 的 是 在 接口 逻辑 的 最 后 ， 程 序 都 会 使 用 render 方 法 来 打印 JSON 格 式 的 消息 数据 。 该 方法 有 3 个 参数 ， 分 别 对 应 的 是 微 博通 信 协 议 中 的 code、message 和 result 信 息 ， 由 于 该 方法 
的 逻辑 实现 和 JSON 协 议 优化 部 分 的 内 容 有 关 ， 所 以 此 方法 的 代码 逻辑 我 们 会 在 9.2.1 节 中 给 大 家 介绍 。 


6.2.2 ”用 户 登 出 接口 


登 出 接口 的 功能 和 登录 接口 相反 ， 当 该 接口 被 调用 时 ， 保存 在 服务 端 Session 会 话 中 的 信息 会 被 清除 ， 此 时 服务 端 则 认为 该 用 户 处 于 未 登录 状态 。 该 接口 的 代码 逻辑 比较 简单 ， 如 代码 清单 6-10 


所 示 。 


代码 清单 6-10 


class IndexServer extends Demos_App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
/** == 


* 


* > 接口 说 明 : 用 户 登 出 接口 

* <code> 

* URL 地 址 : /index/logout 

* 提交 方式 : POST 

* 参数 #1: sid, X2: STRING， 必 须 : YES， 示 例 : 
* </code> 

a ee! 
* Qtitle 用 户 登 出 接口 

* @action /index/logout 

* @method post 

ud 

public function logoutAction () 

{ 

$ SESSION['customer'] = null; 
$this-»render('10000', "Logout ok'); 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


在 验证 接口 这 部 分 内 容 中 ， 除 了 登录 和 登 出 接口 的 代码 逻辑 ， 比 较 重要 的 还 有 控制 器 基 类 中 的 doAuth 方 法 的 代码 逻辑 ， 此 方法 用 于 验证 


登录 状态 ， 所 以 doAuth 方 法 会 被 绝 大 多 数 的 接口 使 用 。 该 方法 位 于 lib/Demos/App/server.php 中 ， 具 体 逻 辑 如 代码 清单 6-11 所 示 。 


代码 清单 6-11 


户 是 否 登录 ， 由 于 绝 大 部 分 的 微 博 服务 端 API 都 要 求 用 户 为 已 


class Demos_App Server extends Hush Service 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


[** 
* Qingore 
ud 
public function doAuth () 
{ 
if (!isset($ SESSION['customer'])) { 
$this-»render('10001', 'Please login firstly.'); 
) eise ( 


$this->customer = $ SESSION['customer']; 
} 
š 


/** 
* @ingore 
* 
public function doAuthAdmin () 
{ 
if (!isset($ SESSION['admin'])) ( 
$this-»forward($this-»apiAuth); // auth action 
) eise ( 


$this->admin = $ SESSION['admin']; 
) 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


从 上 述 代 码 中 我 们 可 以 看 到 doAuth 方 法 的 逻辑 很 简单 ， 如 果 获 取 不 到 Session 会 话 中 用 户 信 息 的 值 ， 即 $_ SESSION['customer] 变 量 的 值 ， 系 统 就 认为 用 户 处 于 未 登录 状态 ， 返 
单 6-12; 反之 ， 系 统 会 认为 用 户 处 于 已 登录 状态 ， 同 时 把 $_ SESSION[' customer] 的 值 放 到 $this-> customer 类 变量 中 ， 供 


他 接口 使 用 。 


代码 清单 6-12 


回 


的 错误 信息 见 代码 清 


"code":"10001", 
"message":"Please login firstly.", 
"result";"" 


6.3 用户 接口 


能 特点 ， 将 它们 都 归 类 到 CustomerServer 控 制 器 下 。 


63.1 新建 用 户 接口 


数 : 


接口 是 微 博 系统 的 核心 接口 ， 目 前 本 书 实例 已 经 实现 了 微 博 用 户 基 本 信息 的 新 增 、 查 看 、 更 新 ， 以 及 添加 和 删除 粉丝 接口 ， 下 面 我 们 将 分 别 对 这 些 接口 做 详细 介绍 。 另 外 ， 我 们 根据 这 些 接口 的 功 


新 建 用 户 接 
户 名 、 密 码 、 签 名 和 头像 ， 当 这 几 个 值 都 存在 的 情况 下 ， 系 统 就 会 创建 新 用 户 了 ， 接 口 逻 辑 见 代码 清单 6-13。 


代码 清单 6-13 


实际 上 就 是 注册 接口 ， 一 般 来 说 微 博 的 手机 客户 端 是 不 提供 注册 功能 的 ， 所 以 目前 该 接口 仅 供 调试 调用 ， 比 如 我 们 可 以 在 调试 后 台 通过 该 接口 创建 需要 的 用 户 。 该 接口 需要 接收 4 个 基本 参 


class CustomerServer extends Demos_App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
J** = 


* 


* > 接口 说 明 : 新 建 用 户 接口 

* <code> 

* URL 地 址 : /customer/customerCreate 

* 提交 方式 : POST 

* 参数 #1: name， 类 型 : STRING， 必 须 : YES 
* 参数 #2: pass, X: STRING， 必 须 : YES 
* 参数 #3: sign， 类 型 : STRING， 必 须 : YES 
* 参数 #4: face， 类 型 : STRING， 必 须 : YES 
* </code> 


* 


* @title 新 建 用 户 接口 

* @action /customer/customerCreate 
* @params name '' STRING 

* @params pass '' STRING 

* @params sign '' STRING 

* @params face '0' STRING 

* @method post 

*/ 


public function customerCreateAction () 


Sthis-»doAuth(); 

$name = $this-»param('name'); 

$pass = $this-»param('pass'); 

$sign = Sthis-»param('sign'); 

$face = $this-»param('face'); 

if ($name && $pass && $sign && $face) { 
$customerDao = $this->dao->load('Core Customer') ; 
$customerDao-»create (array ( T 


'name' => Sname, 
'pass' => Spass, 
'sign' => $sign, 
'face' => $face 


); 

S$this-»render('10000', 'Create customer ok'); 
} 
$this->render ('14005', 'Create customer failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


) 


根据 之 前 的 代码 阅读 经 验 ， 我 们 可 以 很 快 地 了 解 到 新 建 用 户 接口 的 一 些 基 本 信息 : 该 接口 的 方法 名 为 customerCreateAction， 对 应 接 
这 些 参数 值 都 正常 的 情况 下 ， 程 序 就 会 使 用 DAO 类 Core_Customer 中 的 create 方 法 来 向 对 应 的 数据 库 表 customer 中 插入 用 户 数据 。 需 要 注意 的 是 ，Core_Customer 是 微 博 实例 应 用 中 核心 


地 址 为 /customercustomerCreate， 该 接口 需 


要 4 个 参数 ， 当 


户 模型 的 实 


现 ， 也 是 所 有 用 户 接口 中 最 经 常 使 用 到 的 DAO 类 之 一 ， 该 类 的 代码 在 lib/Demos/Dao/Core/Customer.php 下 ， 大 家 可 以 结合 3.6 节 中 对 Hush Framework 的 介绍 ， 预 先 熟悉 一 下 Core_Customer 模 型 类 的 
代码 ， 该 类 在 6.3 节 其 他 的 几 个 用 户 接口 中 也 会 使 用 到 。 


Core_Customer 类 中 的 create 方 法 的 用 法 比较 简单 ， 我 们 只 要 在 参数 中 传 入 需要 保存 的 数据 (一 般 我 们 会 使 用 散 列 数组 来 表示 ) ， 框 架 会 自动 帮 有 我 们 把 这 条 数据 插入 数据 库 表 中 。 另 外 ， 我 们 在 


Core_Customer 类 的 源码 中 是 看 不 到 create 方 法 的 ， 这 些 CRUD 方 法 都 已 经 在 Hush Framework 框 架 中 封装 好 了 ， 关 了 


接口 执行 成 功 之 后 返回 的 JSON 消 息 ， 如 代码 清单 6-14 所 示 ，code 为 10000 代 表 的 操作 已 经 成 功 ，message 也 提示 我 们 成 功 创建 用 户 。 


代码 清单 6-14 


这 些 DAO 类 常用 方法 的 用 法 请 参考 3.6.3 节 。 


"code":"10000", 
"message" :"Create customer ok", 
"result";"" 


如 果 输 


入 参数 不 完全 或 者 遇 到 其 他 的 情况 ， 接 口 会 返回 失败 的 JSON 消 息 ， 具 体 的 消息 如 代码 清单 6-15 所 示 。 


代码 清单 6-15 


实际 上 
样 在 出 错时 
同 , BEE 


"code":"14005", 
"message" : "Create customer failed", 
"result":"" 


， 绝 大 部 分 的 非 查询 操作 返回 信息 和 以 上 的 JSON 消 息 代码 都 非常 相似 ，code 为 10000 表 示 接 口 执行 成 功 ， 其 他 返回 基本 都 属于 错误 消息 ， 在 项 目 中 我 们 经 常 把 每 种 错误 都 赋予 唯一 的 code， 这 


我 们 就 可 以 马上 定位 错误 的 位 置 和 原因 。 在 随后 的 章节 中 将 再 次 出 现 返回 错误 代码 的 情况 ， 我 们 将 使 用 “1**** 错 误 代 码 ”来 代表 类 似 格式 的 JSON 代 码 ， 对 应 代码 的 内 容 与 代码 清单 6-15 基 本 相 


63.2 ”更 新 用 户 信息 接口 


更 新 


户 信息 接口 是 供用 户 修改 个 人 信息 的 ， 该 接口 接收 两 个 参数 key 和 val，key 表 示 信 息 字段 的 名 称 ，val 则 表示 信息 字段 的 值 ; 这 种 接口 设计 方式 是 针对 key-value ( 键 值 对 ) 类 型 的 数据 结构 设计 
的 ， 好 处 是 通用 性 比较 强 ， 我 们 可 以 根据 传 入 的 任意 key 来 更 新 任意 值 ， 而 在 本 接口 中 ， 则 为 修改 用 户 的 各 种 信息 。 接 口 允 辑 参考 代码 清单 6-16。 


小 贴 士 : “key-value ( 键 值 对 ) ”型 数据 的 特点 是 键 名 和 键 值 成 对 出 现 ， 我 们 可 以 根据 任意 键 名 查 到 对 应 的 键 值 ， 在 互联 网 应 用 中 这 种 数据 结构 是 相当 常见 的 ， 比 如 这 里 的 用 户 配置 信息 就 是 一 个 很 好 


的 实例 。 


代码 清单 6-16 


class CustomerServer extends Demos_App Server 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
* 


~ 
+ * 


> 接口 说 明 : 更 新 用 户 


<code> 


URL 地 址 : /customer/customerEdit 
提交 方式 : POST 

BUH: key, 32: STRING， 必 须 : YES 
参数 #2: val， 类 型 : STRING， 必 须 : YES 
</code> 


HO O 


* 


@title 更 新 用 户 信息 
@action /customer/customerEdit 
@params key '' STRING 

Gparams val '' STRING 

Gmethod post 


* ROO * * 
~ 


public function customerEditAction () 


{ 
Sthis-»doAuth(); 
$key = $this-»param('key'); 
$val = $this-»param('val'); 
if ($key) { 
$customerDao = $this->dao->load('Core_Customer') ; 
try ( 
ScustomerDao->update (array ( 
'id' => Sthis-»customer['id'], 
Skey => $val, 
); 
) catch (Exception $e) { 
$this-»render('14003', 'Update customer failed'); 


š 
$this->render('10000', 'Update customer ok'); 


} 
Sthis-»render('14004', 'Update customer failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


该 接口 


的 方法 名 为 customerEditAction ， 对 应 的 URL 地 址 是 /customer/customerEdit， 该 接口 需要 2 个 参数 ， 当 key 存 在 的 时 候 就 调 


DAO 类 Core_Customer 的 update 方 法 来 进行 数 直 


居 库 更 新 操作 。 


我 们 需要 注意 两 点 : 其 一 ， 这 里 的 update 方 法 和 新 建 用 户 接口 中 的 create 方 法 同属 于 DAO 类 的 CRUD 方 法 ， 其 用 法 和 参数 都 比较 相似 ， 但 是 ， 因 为 更 新 操作 必须 知道 会 影响 的 是 数据 表 中 的 哪 行 ， 所 以 该 参 
数 中 的 散 列 数组 必须 包含 主键 ， 用 于 指定 该 行 的 位 置 ; 其 二 ， 我 们 使 用 了 try catch 语 句 来 捕获 update 操 作 的 异常 ， 更 新 失败 时 程序 就 会 返回 14003 错 误 代码 。 


633 ”查看 用 户 信息 接口 


查看 用 户 信息 接口 功能 很 简单 ， 就 是 根据 用 户 1D 来 查询 用 户 数据 ， 该 接口 仅 接收 一 个 参数 ， 即 用 户 ID (customerld) ， 然 后 根据 此 参数 值 来 获取 对 应 用 户 的 信息 。 接 口 逻辑 可 参考 代码 清单 6-17。 


代码 清单 6-17 


class CustomerServer extends Demos_App Server 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
* 


* > 接口 说 明 : 查看 用 户 信息 接口 

* <code> 

* URL 地 址 : /customer/customerView 

* 提交 方式 : POST 

* 参数 #1: CustomerId， 类 型 : INT， 必 须 : YES 
* </code> 


Gtitle 查看 用 户 信息 
@action /customer/customerView 
@params customerId 1 INT 
@method post 


ROO 
~ 


public function customerViewAction () 
{ 
$this->doAuth () ; 
$customerId = $this->param('customerId'); 
// 获取 用 户 的 详细 信息 
$customerDao = $this->dao->load('Core Customer') ; 
if ($customerDao->exist ($customerId)) ( 
$customerItem = $customerDao->getById ($customerld); 
Sthis-»render('10000', 'View customer ok', array( 
'Customer' => ScustomerItem 
) ) 7 
l 
$this-»render('14002', 'View customer failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


该 接口 名 为 customerViewAction， 对 应 URL 地 址 是 /customercustomerView， 接 口 逻 辑 不 复杂 ， 在 接收 到 用 户 1D 的 值 后 ， 先 调 用 DAO 类 Core Customer 中 的 exist 方 法 来 判断 用 户 是 否 存在 ， 若 验证 


存在 则 调用 getByld 方 法 来 获取 用 户 的 所 有 信息 ， 最 后 使 用 render 方 法 来 输出 正确 的 返回 信息 ， 反 之 则 返回 14002 错 误 代 码 。 假 如 ， 我 们 在 调试 后 台 使 用 customerld 为 1 来 测试 ， 接 口 则 会 返回 ID 为 1 的 用 户 


的 信息 ， 如 代码 清单 6-18 所 示 。 


代码 清单 6-18 


"code":"10000", 
"message":"View customer ok", 
"result": { 


"Customer": { 
"id, 


"blogcount":0, 


0 
2012-04-01 08:19:27", 
:"http:\/\/localhost :8002\/faces\/default\/face_0.png" 


该 接口 的 返回 信息 也 包含 了 一 个 Customer 模 型 对 象 ， 这 和 6.2.1 节 “用 户 登录 接口 ”中 的 返回 很 类 似 ， 不 过 我 们 会 发 现 本 接口 的 模型 对 象 比 “ 用 户 登录 接口 ”的 少 了 一 个 sid 字 段 ， 这 是 因为 这 里 并 不 需 


要 这 个 字段 ; 然后 ， 客 户 端 会 根据 服务 端 返 回 的 模型 对 象 字段 来 给 客户 端的 模型 对 象 设 值 。 这 里 需要 注意 的 是 ， 在 服务 端 返 回 的 模型 对 象 中 ， 少 几 个 字段 是 没 问题 的 ， 但 是 如 果 多 出 字段 ， 客 户 端 获取 时 就 


会 出 错 ， 具 体 的 原因 和 处 理 逻 辑 我 们 会 在 7.3.3 节 中 给 大 家 做 进一步 的 介绍 。 


在 customerViewAction 方 法 中 ， 我 们 还 需要 注意 用 户 接口 主要 DAO 类 Core_ Customer 的 两 个 方法 的 使 用 ， 一 个 方法 是 exist， 此 方法 是 除 CRUD 方 法 之 外 Hush Framework 的 DAO 基 类 为 我 们 封装 好 


的 另 一 个 常用 方法 ， 也 就 是 使 用 主键 来 判断 数据 是 否 存在 ， 要 注意 的 是 此 方法 和 read 方 法 一 样 都 必须 传 入 主键 的 值 来 进行 判断 和 选择 ; 另 一 个 方法 是 getByld， 此 方法 并 非 框架 封装 好 的 方法 ， 而 是 在 


Core_Customer 类 中 实现 的 ， 


代码 如 代码 清单 6-19 所 示 。 


小 贴 士 : 在 Hush Framewotk 的 DAO 类 中 ， 我 们 通常 使 用 常量 TABLE_NAME 来 定义 表 名 ， 而 常量 TABLE_PRIM 则 用 来 定义 主键 名 ， 默 认 主 键 名 为 id。 


代码 清单 6-19 


class Core Customer extends Demos Dao Core 

{ 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
n 


* Get customer by id 

* @param int $id 

* 

public function getById ($id) { 
Scustomer = $this->read ($id); 
$customer['faceurl'] = Demos Util Image::getFaceUrl ($customer['face']); 
return $customer; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


Core Customer 类 中 的 getByld 方 法 用 于 取得 用 户 的 基本 信息 ， 此 方法 的 逻辑 比较 简单 ， 首 先 使 用 read 方 法 查询 出 数据 库 中 存储 的 用 户 基本 信息 ， 然 后 再 调用 Demos_Util_ Image 工 具 类 中 的 
getFaceUr| 方 法 拼装 出 可 用 于 显示 的 用 户头 像 信息 ， 最 后 再 组 合成 完整 的 用 户 数据 并 返回 。 这 种 在 获取 到 原始 数据 之 后 进行 再 加 工 ， 然 后 重组 并 返回 的 逻辑 我 们 在 实际 项 目 中 也 是 经 常用 到 的 ， 大 家 可 以 结 


合 这 里 的 代码 逻辑 来 体会 。 至 于 Demos_Util_Image 工 具 类 中 主要 方法 的 代码 和 逻辑 ， 我 们 会 在 6.6 节 中 与 图 片 接口 部 分 一 同 介绍 。 


6.3.4. 添加 粉丝 接口 


接口 。 本 节 将 介绍 添加 粉丝 接口 ， 接 


在 微 博 系统 中 ， 用 户 之 间 的 社交 关系 并 非 双向 的 好 友 关系 ， 而 是 单 向 的 关注 和 被 关注 的 关系 ， 这 应 该 也 算是 微 博 区 别 于 传统 互联 网 应 用 的 一 个 主要 特点 。 单 向 关系 比 传统 的 双向 关系 更 加 简单 和 直接 ， 
因此 也 更 容易 被 大 众 所 接 受 ; 另外 ， 微 博 系统 还 引入 了 “粉丝 ”的 概念 ， 让 这 种 新 型 的 社交 关系 更 加 深入 人 心 ， 也 更 受 一 些 名 人 的 欢迎 。 微 博 的 关注 系统 包括 “添加 粉丝 ”和 “删除 粉丝 ”这 两 个 最 基本 的 
逻辑 如 代码 清单 6-20 所 示 。 


代码 清单 6-20 


class CustomerServer extends Demos App Server 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


> 接口 说 明 : 添加 粉丝 接口 

<code> 

URL 地 址 : /customer/fansAdd 

提交 方式 : POST 

参数 #1: customerId， 类 型 : INT， 必 须 : YES 
</code> 


HO OF 


Gtitle 添加 粉丝 接口 
@action /customer/fansAdd 
@params customerId '' INT 
@method post 


HO * * * 
=< 


public function fansAddAction () 
{ 
$this->doAuth () ; 
ScustomerId = $this-»param('customerld'); 
if ($customerId) { 
$fansDao = $this-»dao-»1oad('Core CustomerFans'); 
if (!$fansDao-»exist($customerId, $this-»customer['id'])) { 
// 添加 关系 数据 
$fansDao->create (array ( 
'customerid' 
'fansid' 


=> $customerld, 
=> Sthis-»customer['id'] 


YF 
// 更 新 用 户 表 粉 丝 个 数 
$customerDao = $this->dao->load('Core Customer') ; 
$customerDao->addFanscount ($customerId) ; 
// 更 新 消息 表 添加 消息 
SnoticeDao = $this->dao->load('Core Notice'); 
SnoticeDao->addFanscount ($customerId) ; 
$this-»render('10000', 'Add fans ok'); 

} 


} 
$this->render ('14006', 'Add fans failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


添加 粉丝 接口 的 方法 名 为 fansAddAction， 对 应 URL 地 址 为 /customer/fansAdd， 此 方法 仅 接 收 一 个 参数 ， 也 就 是 customerld， 此 参数 的 含义 不 是 当前 微 博 F 
户 1D 一 起 存放 到 关系 表 customer fans 中 去 ， 程 序 中 的 Core CustomerFans 则 是 此 关 


场景 来 讲 ， 用 户 在 客户 端 单 击 “ 加 关注 ”按钮 之 后 ， 便 会 发 送 请求 到 此 接口 
系 表 的 对 应 DAO 类 。 


CASE 


， 传 入 被 关注 


户 的 ID， 然 后 连同 


为 了 便于 大 家 理解 ， 有 必要 强调 一 下 关系 表 的 概念 。 关 系 表 中 保存 的 是 主 表 之 间 数 据 的 关系 。 关 系 表 的 命 


户 的 ID， 而 是 被 关注 


户 的 ID; 结合 实例 


遵循 某 些 规则 ， 我 们 一 般 会 在 相互 之 间 存 在 关联 关系 的 两 张 或 者 多 张 主 表 的 名 称 之 间 加 上 下 


划 线 ， 以 此 来 作为 关系 表 的 名 称 ; 当然 如 果 是 一 张 主 表 内 部 的 关系 ， 则 可 以 使 用 主 表 名 加 上 关系 描述 来 表示 该 关系 表 的 意义 ， 比 如 customer_fans 表 保存 的 就 是 用 户 表 ， 即 customer 表 内 部 的 关联 关系 。 


观察 fansAddAction 接 口 的 逻辑 ， 相 对 于 之 前 的 几 个 
Core CustomerFans 中 的 exist 方 法 来 判断 这 条 关系 数据 是 否 已 经 存在 ， 此 方法 代码 如 代码 清单 6-21 所 示 。 


代码 清单 6-21 


class Core CustomerFans extends Demos_Dao_Core 
{ 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
** 


* Check fans data exists 

* @param int $customerId 

* @param int $fansId 

* @return array 

xp 

public function exist ($customerId, $fansId) 


$sql = $this->select ()->from($this->t1l, '(1)') 
->where ("Customerid = ?", $customerId) 
-»where("fansid = ?", $fansId); 

return $this->dbr () ->fetchOne ($sql); 


) 
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} 


户 接口 来 说 会 更 复杂 一 些 ， 接 下 来 我 们 将 逐步 分 析 该 方法 的 所 有 逻辑 。 首 先 ， 在 接收 到 customerld 之 后 ， 程 序 会 调 


关系 表 DAO 类 


键 ”， 联 合 


键 经 


与 前 面 的 查看 用 户 信息 接口 ( 见 6.3.3 节 ) 中 的 exist 方 法 不 同 ， 该 方法 接收 的 参数 并 不 是 单个 主键 的 值 ， 而 是 两 个 主键 的 值 ， 这 种 使 用 多 个 键 作为 主键 的 情况 我 们 通常 称 之 为 “联合 
常 在 一 些 关系 表 中 被 使 用 。 根 据 之 前 学 习 到 的 知识 和 代码 阅读 经 验 ， 我 们 可 以 看 出 这 段 查询 操作 代码 所 对 应 的 SQL 为 “SELECT (1) FROM customer fans WHERE customer=AND fansid=”， 这 里 有 两 
个 地 方 需要 引起 我 们 的 重视 。 其 一 是 “SELECT (1) ”的 用 法 含义 ， 我 们 之 前 所 用 到 的 查询 SQL 通常 都 是 用 于 查询 表 中 某 些 或 者 全 部 字段 的 情况 ， 然 而 对 于 只 需要 判断 数据 行 是 否 存 在 的 情况 ， 任 何 额 外 的 
数据 存 取 都 是 资源 浪费 ， 因 此 这 种 用 法 是 效率 最 高 的 。 其 二 就 是 fetchOne 方 法 的 用 法 ， 由 于 这 里 我 们 只 需要 查询 单个 字段 值 ， 因 此 使 用 fetchOne 方 法 是 最 合适 的 。 

回 到 fansAddAction 接 口 方法 的 逻辑 ， 在 判断 了 关系 数据 是 否 存在 之 后 ， 程 序 接着 往 下 运行 。 如 果 关注 记录 已 经 存在 就 表示 你 已 经 关注 过 该 用 户 ， 程 序 会 返回 错误 代码 14006， 提 示 消 息 为 “Add fans 


failed”， 即 添加 粉丝 失败 ; 当然 ， 如 果 判 断 结果 是 关注 记录 不 存在 ， 程 序 就 需要 执行 “加 关注 ”操作 ， 此 处 逻辑 分 三 个 步骤 。 


1. 添 加 关系 数据 


调用 DAO 类 Core_CustomerFans 的 create 方 法 来 向 用 户 粉 丝 表 插 入 关系 数据 ， 该 表 有 三 个 字段 ， ID、 粉 丝 ID 和 更 新 时 间 。 其 中 用 户 ID 是 接 
也 就 是 登录 用 户 的 ID 值 ， 而 更 新 时 间 就 是 程序 执行 的 当前 时 间 。 至 于 create 方 法 的 用 法 之 前 已 经 介绍 过 了 ， 这 里 不 再 歼 述 。 

2. 更 新 用 户 表 

更 新 用 户 表 的 原因 是 Customer 表 中 有 个 字段 与 添加 粉丝 接口 有 关系 ， 那 就 是 用 户 的 粉丝 数 ， 这 个 元 余 字段 是 为 了 便于 查询 而 设计 的 ， 因 此 在 给 被 关注 的 上 
程序 使 用 Core_Customer 类 中 的 addFanscount 方 法 来 完成 更 新 操作 ， 代 码 见 代码 清单 6-22。 


代码 清单 ”6-22 


class Core Customer extends Demos Dao Core 
{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function addFanscount ($id, $addCount = 1) 
{ 
$customer = $this->read ($id); 
$customer['fanscount'] = intval ($customer['fanscount']) 
$this-»update ($customer) ; 


+ SaddCount; 


) 
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} 


口 所 接收 到 的 customerld 的 参数 值 ， 粉 丝 ID 是 当前 用 户 


户 添加 粉丝 时 ， 同 时 需要 给 他 的 粉丝 数 加 一 。 


Core Customer 类 中 的 addFanscount 方 法 逻辑 比较 简单 ， 先 用 read 人 方法 读 取 目 标 用 户 的 信息 ， 然 后 给 它 的 fanscount 字 段 ， 也 就 是 粉丝 数 的 值 加 1， 最 后 再 使 用 update 方 法 更 新 到 数据 库 表 中 。 


3. 更 新 消息 表 


之 所 以 更 新 消息 表 是 因为 我 们 的 微 博 应 用 有 一 项 特殊 功能 ， 就 是 当 有 用 户 加 你 为 粉丝 的 时 候 ， 系 统 会 自动 给 你 发 一 条 通知 信息 ， 我 们 使 


码 清单 6-23 所 示 。 


代码 清单 6-23 


class Core Notice extends Demos_Dao_Core 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function addFanscount ($customerId, SaddCount = 1) 
{ 
$sql = $this->select ()->from($this->tl, '*') 
-»where ("customerid = ?", $customerId) 
-»where ("status = 0"); 
$row = Sthis-»dbr()-»fetchRow ($sql); 
// 只 处 理 未 读 通知 
if ($row) { 


$fanscount = intval ($row['fanscount']) + $addCount; 
$this-»update (array ( 
'id' => intval($row['id']), 
'fanscount' => Sfanscount 
)); 
// 新 建 通知 
) else ( 
$this->create (array ( 
'customerid' => S$customerld, 
'fanscount' => 1 


)); 
] 


) 
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} 


Core_Notice 类 中 的 addFanscount 方 法 来 实现 这 个 功能 ， 如 代 


Core_Notice 类 中 的 addFanscount 方 法 逻辑 相对 复杂 一 些 ， 


序 会 查找 未 读 过 的 通知 ， 若 存在 ， 则 更 新 通知 新 粉丝 的 数量 ; 若 不 存在 ， 则 给 目标 用 户 创建 一 个 新 的 通知 。 在 客户 端 获取 通知 时 ， 服 务 端 就 会 把 该 用 户 的 通知 信息 返回 。 


为 这 里 涉及 通知 接口 的 逻辑 ; 不 过 ， 这 里 我 们 主要 关注 更 新 通知 粉丝 数量 的 逻辑 即 可 ， 关 于 通知 模块 的 详细 内 容 请 参考 6.7 节 。 首 先 ， 程 


以 上 逻辑 全 部 执行 完 之 后 ， 接 口 会 返回 代码 为 10000 的 成 功 信息 ， 对 应 的 提示 信息 为 “Add fans ok" ， 即 添加 粉丝 成 功 。 至 此 添加 粉丝 的 逻辑 就 全 部 结束 了 ， 此 接口 涉及 的 知识 点 比较 多 ， 大 家 应 该 好 


好 地 理解 和 体会 。 


6.3.5 ”删除 粉丝 接口 


删除 粉丝 接口 所 完成 的 实际 上 就 是 取消 关注 功能 。 和 添加 粉丝 接口 一 样 ， 该 接口 也 仅 接 收 一 个 参数 ， 就 是 customerld， 代 表 的 是 被 取消 关注 的 用 户 ID， 接 口 逻辑 见 代码 清单 6-24。 


代码 清单 ”6-24 


class CustomerServer extends Demos_App Server 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
J>» = 


> 接口 说 明 : 删除 粉丝 接口 

<code> 

URL 地 址 : /customer/fansDel 

提交 方式 : POST 

参数 #1: customerId， 类 型 : INT， 必 须 : YES 
</code> 


Gtitle 删除 粉丝 接口 
@action /customer/fansDel 
@params customerId '' INT 
@method post 


* * * * 


* 
$ 
public function fansDelAction () 
{ 
$this->doAuth () ; 
$customerId = $this-»param('customerld'); 
if ($customerId) { 
$fansDao = $this->dao->load('Core CustomerFans'); 
if ($fansDao->exist ($customerId, Şthis->customer['id'])) { 
$fansDao->delete ($customerId, $this->customer['id']) 
$this->render ('10000', 'Delete fans ok'); 


š 
} 
$this->render ('14007', 'Delete fans failed'); 


} 
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删除 粉丝 接口 的 Action 方 法 名 为 fansDelAction， 对 应 URL 地 址 为 /customerfansDel， 该 接口 的 逻辑 比 添加 粉丝 接口 要 简单 一 些 。 首 先 ， 程 序 会 使 用 DAO 类 Core CustomerFans 中 的 exist 方 法 来 判断 


回 


该 粉丝 关系 是 否 存在 ， 这 点 和 添加 粉丝 接口 类 似 ，exist 方 法 的 代码 逻辑 可 参考 前 面 的 代码 清单 6-21。 如 果 返 
据 ， 由 于 该 表 使 用 的 是 “联合 主键 ”， 所 以 这 里 的 delete 方 法 也 是 需要 我 们 自己 来 实现 的 ， 该 方法 逻辑 见 代码 清单 6-25。 


代码 清单 ”6-25 


结果 为 该 粉丝 关系 存在 ， 则 需要 使 用 Core_ CustomerFans 类 中 的 delete 方 法 来 删除 该 关系 数 


class Core CustomerFans extends Demos Dao Core 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function delete ($customerId, $fansId) 
{ 
$wheresql = "customerid = $customerId and fansid = $fansId"; 
return Sthis->dbw()->delete($this->t1, $wheresql); 
l 
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上 述 delete 方 法 的 逻辑 中 有 两 个 知识 点 需要 注意 一 下 。 其 一 ， 删 除 方法 需要 使 用 写 库 ， 因 此 我 们 需要 使 用 dbw 方 法 来 选中 写 库 ， 关 于 这 点 前 面 已 经 举 过 很 多 类 似 的 例子 ， 这 里 不 再 歼 述 ; Bb, BAK 
中 的 delete 方 法 和 DAO 基 类 中 的 delete 方 法 是 不 同 的 ， 由 于 我 们 不 能 根据 单独 主键 来 删除 数据 ， 所 以 也 无 法 使 用 DAO 基 类 中 的 delete 方 法 ， 这 里 的 delete 方 法 实际 上 是 Hush Framework 底 层 Db 类 中 的 


delete 方 法 ， 该 方法 有 两 个 参数 ， 分 别 是 表 名 和 WHERE 语句 。 


回 到 fansDelAction 接 口 方法 的 逻辑 ， 若 删除 操作 成 功 则 返回 代码 为 10000 的 成 功 信息 ， 提 示 信 息 为 “Delete fans ok" ， 即 删除 粉丝 成 功 ; 反之 ， 返 回 的 是 14007 错 误 代 码 ， 提 示 信 息 为 “Delete fans 


failed" ， 即 删除 粉丝 失败 。 


6.4 微 博 接口 


微 情 接口 是 微 博 系统 中 最 重要 的 接口 ， 这 组 接口 包括 创建 微 博 、 查 看 微 博 以 及 微 博 列表 这 些微 博 系统 的 基本 接口 ， 下 面 我 们 将 分 别 对 这 几 个 接口 做 详细 介绍 。 我 们 根据 这 些 接口 功能 的 特点 ， 将 其 归 类 
到 BlogServer 控 制 器 下 。 


6.4.1 ”发 表 微 博 接口 


客户 端 写 微 博 的 时 候 调 用 的 就 是 发 表 微 博 接口 ， 该 接口 的 功能 比较 简单 ， 就 是 把 用 户 撰写 的 微 博 保 存 到 blog 数 据 表 中 。 接 口 逻 辑 见 代码 清单 6-26。 


代码 清单 6-26 


class BlogServer extends Demos App Server 
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/** 


E 


* > 接口 说 明 : 发 表 徽 博 接口 

* <code> 

* URL 地 址 : /blog/blogCreate 

* 提交 方式 : POST 

* 参数 #1: Content， 类 型 : STRING， 必 须 : YES 
* </code> 


* 


* @title 发 表 微 博 接口 
* @action /blog/blogCreate 
* @params content '' STRING 
* (method post 
AX 
public function blogCreateAction () 
š 
Sthis->doAuth () ; 
$content = $this->param('content'); 
if ($content) { 
// 保存 微 博 内 容 
$blogDao = $this->dao->load('Core Blog'); 
$blogDao->create (array ( = 


'customerid' => $this-»customer['id'], 
'desc" => "'', 

'title' = t! 

"content! => $content, 

'commentcount ' => 0 


) ) 7 

// 更 新 用 户 微 博 数量 

$customerDao = $this->dao->load('Core Customer'); 
$customerDao-»addBlogcount ($this->customer['id']); 
$this->render('10000', 'Create blog ok'); 


} 
Sthis-»render('14009', 'Create blog failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


首先 ， 接 口 使 用 param 方 法 接收 传 来 的 微 博 内 容 并 保存 到 $content 变 量 中 ， 目 前 的 验证 逻辑 仅 为 若 微 博 内 容 不 为 空 ， 则 使 用 DAO 类 Core_Blog 中 的 create 方 法 来 保存 微 博 内 容 至 微 博 信息 表 blog， 关 于 
blog 表 的 介绍 请 参考 4.7 节 中 的 内 容 。 当 然 我 们 可 以 根据 需要 ， 在 这 里 添加 更 多 的 限制 逻辑 ， 比 如 微 博 内 容 长 度 不 能 超过 140 个 字 等 。 


在 保存 微 博信 息 之 后 ， 还 需要 更 新 用 户 微 博 的 数量 ， 也 就 是 customer 表 中 的 blogcount 字 段 ， 这 个 元 余 字段 中 存储 的 是 微 博 用 户 的 微 博信 息 ， 主 要 用 于 快速 查询 ， 这 点 和 之 前 介绍 到 的 fanscount 字 段 
类 似 。 相 关 逻 辑 可 参考 代码 清单 6-27。 


代码 清单 6-27 


class Core Customer extends Demos Dao Core 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public function addBlogcount ($id, $addCount - 1) 
{ 
Scustomer = $this->read ($id); 
$customer['blogcount'] = $customer['blogcount'] + $addCount; 
Sthis-»update ($customer); 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


最 后 ， 发 表 微 博 逻 辑 结束 后 ， 返 回 10000 正 确信 息 ， 提 示 “create blog ok”， 也 就 是 发 表 微 博 成 功 ; 反之 则 返回 14009 错 误 代码 ， 提 示 “create blog failed”， 也 就 是 发 表 微 博 失 败 。 


642 ”查看 微 博 接 口 


查看 微 博 接口 用 于 微 博 正文 界面 ， 当 用 户 在 客户 端点 击 某 条 具体 微 博时 就 会 打开 微 博 正 文 界面 ， 此 时 ， 客 户 端 会 把 这 条 微 博 的 ID 发 送 到 服务 端的 查看 微 博 接口 ， 来 获取 微 博 的 详细 信息 ， 接 口 逻辑 请 参 
考 代 码 清单 6-28。 


代码 清单 6-28 


class BlogServer extends Demos App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
/** 
* == 
* > 接口 说 明 : 
* <code> 
* URLjbbhk: /blog/blogView 
* 提交 方式 : POST 
* 
* 


参数 #1: blogTd， 类 型 : INT, 2246: YES, f: 1 
</code> 

* @title 查看 微 博 正文 接口 

* @action /blog/blogView 

* @params blogid 1 INT 

* @method post 


ad 


* 


public function blogViewAction () 
{ 
Sthis-»doAuth(); 
$blogId = intval($this-»param('blogId')); 
$blogDao = $this->dao->load('Core Blog'); 
$blogItem = $blogDao->read ($blogId); 
$customerDao = $this->dao->load('Core Customer'); 
$customerItem = $customerDao->getById ($blogItem['customerid']); 
$this-»render('10000', 'Get blog ok', array( 
'Customer' => $customerItem, 
'Blog' => $blogItem 
); 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


查看 微 博 接口 对 应 的 控制 器 方法 名 为 blogViewAction， 对 应 API 接 口 的 URL 地 址 为 /blog/blogView， 此 接口 的 逻辑 并 不 复杂 ， 在 获取 到 博文 1D 之 后 程序 会 调 上 
Core_Customer 类 中 的 getByld 获 取 相 关 作者 的 个 人 信息 ， 此 方法 逻辑 在 6.3.3 节 中 已 经 介绍 过 ， 


blog 表 中 获取 对 应 博文 的 所 有 信息 ; 之 后 ， 再 使 
的 返回 信息 ， 如 代码 清单 6-29 所 示 。 


代码 清单 6-29 


DAO 类 Core_Blog 中 的 read 方 法 ， 从 
体 逻 辑 请 参考 代码 清单 6-19。 这 里 需要 注意 的 是 该 接 


"code":"10000", 

"message":"Get blog ok", 

"result": 
"Customer": { 


rl, 


ei, 
"uptime":"2012-04-01 08:19:27", 
"faceurl": "http: \/\/localhost :8002\/faces\/default\/face_0.png" 


":"test blog 1", 
"uptime":"2012-04-01 15:37:10" 


和 前 面 介绍 过 的 接 [ 
时 返回 ”的 功能 


不 同 ， 本 接 [ 
本 框架 的 一 大 亮点 ， 下 面 我 们 重点 来 说 明 一 下 这 种 数据 组 织 方式 的 优点 。 


在 传统 的 接口 程序 中 ， 我 们 常常 为 不 同 的 功能 开辟 不 同 的 接口 。 比 如 在 微 博 正文 界面 中 ， 我 们 既 要 显示 微 博 的 详细 信息 ， 又 要 显示 


口 ”获取 微 博信 息 ， 然 后 再 调用 “查看 用 户 信息 接口 ”来 获取 


同时 返回 了 Customer 和 Blog 两 个 模型 对 象 ， 这 是 因为 在 微 博 正文 界面 里 ， 除 了 要 显示 微 博 的 信息 . 


外 ， 还 需要 显示 微 博 作 者 的 个 人 信息 。 实 际 上 ， 支 持 “ 多 模型 同 


的 个 人 信息 。 按 照 传 统 的 思路 ， 我 们 会 先 调用 “查看 微 博 接 


户 信息 。 但 是 这 种 思路 有 一 个 很 大 的 问题 ， 假 如 每 个 功能 都 访问 服务 端 接口 ， 会 大 大 增加 系统 资源 的 消耗 ， 一 方面 客户 端 需要 为 每 次 访问 创 


建 请 求 线程 ， 另 一 方面 服务 端 也 需要 为 每 次 访问 准备 处 理 线程 ， 这 个 过 程 其 实 是 移动 互 


PPO AY, 


程序 中 最 耗费 资源 的 部 分 ， 也 是 我 们 最 需要 注意 的 地 方 之 一 。 因 此 ， 在 本 实例 框架 中 ， 我 们 就 采 


了 把 多 个 


请 求 合并 起 来 ， 统 一 处 理 并 返回 的 方式 来 应 对 这 个 问题 。 当 然 ， 从 实际 运 


我 们 把 这 种 比较 常见 的 服务 端 优化 技巧 称 为 “请 求 合并 ”， 其 对 应 的 返回 数据 则 被 命名 为 “混合 型 ”数据 ; 当然 ， 为 了 让 客户 端 程序 能 够 支持 这 种 


的 效果 中 我 们 可 以 看 到 ， 这 种 做 法 能 大 大 减少 网 络 请 求 带 来 的 资源 消耗 ， 提 高 网 络 应 


的 运行 效率 。 


“混合 型 ”返回 数据 ， 我 们 也 做 了 不 少 工作 。 想 要 了 


解 相关 的 处 理 细节 请 参考 7.9 节 中 的 内 容 。 
小 贴 士 : 


中 也 采用 了 类 似 的 技术 来 提高 HTTP 服务 器 的 性 能 。 


643 ” 微 博 列表 接口 


微 博 列表 可 以 算是 微 博 系 统 中 最 核心 的 接口 之 一 ， 该 接 [ 


实际 上 包含 了 3 个 接口 的 功能 ,分 别 是 所 有 人 的 微 博 列表 ， 


“请 求 合 并 ”是 HTTP 服 务 优化 中 经 常 要 做 的 事情 ， 除 了 本 书 介 绍 的 处 理 方式 之 外 ， 我 们 还 经 常 在 一 些 “ 事 件 驱 动 ”的 设计 模式 中 使 用 到 类 似 的 优化 技巧 。 据 了 解 ， 淘 宝 网 的 Web 服 务 器 Tengine 


自己 的 微 博 列 表 以 及 关注 


户 的 微 博 列 表 ， 前 面 两 个 接 [ 


分 别 对 应 了 微 博 主 界面 和 我 


的 微 博 列表 界面 ， 而 第 三 个 接口 在 本 书 实例 中 暂 未 实现 。 微 博 列表 接口 的 接 


代码 清单 6-30 


class BlogServer extends Demos App Server 


{ 


逻辑 如 代码 清单 6-30 所 示 。 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
J** = 


> 接口 说 明 : 微 博 列表 接口 
<code> 

URL 地 址 : /blog/blogList 
提交 方式 : GET 

参数 #1: typeId， 类 型 : INT, 
参数 #2: pageId， 类 型 : INT, 
</code> 


必须 : YES 


* 
* 

* 

* 

* 

* 

* 

* 

"Rec "———————————————————— 
* Qtitle 微 博 列表 接口 

* @action /blog/blogList 
* @params typeId 0 0: 全 部 ，1: 自己 ，2: 关注 
* @params pageId 0 INT 

* @method get 

* 

ub. 


lic function blogListAction () 


Sthis-»doAuth(); 
$typeId = intval(S$this-»param('typeld!') 
$pageld = intval($this-»param('pageId') 
SblogList = array(); 
switch ($typeId) ( 
case 0: 
SblogDao = $this-»dao-»load('Core Blog'); 
SblogList = $blogDao->getListByPage ($pageld); 
break; 
case 1: 
SblogDao = $this-»dao-»load('Core Blog'); 


); 
Ye 


SblogList = $blogDao->getListByCustomer ($this-»customer['id'], $pageId); 


break; 
case 2: 
break; 


} 
if ($blogList) { 
$this->render ('10000', 'Get blog list ok', array( 
'Blog.list' => $bloglist 
); 


l 
Sthis-»render('14008', 'Get blog list failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


查看 微 博 接口 的 对 应 方法 名 为 blogListAction， 对 应 API 接 
博 列 表 ，1 表 示 获 取 自己 的 微 博 列表 ，2 则 表示 获取 关注 
$pageld。 在 接收 到 参数 之 后 ， 程 序 通 过 了 一 个 switch 语 句 ， 根 据 不 同 


的 URL 地 址 为 /blog/blogList。 此 接 


的 typeld 值 分 


处 理 。 


接收 两 个 参数 ， 第 一 个 参数 为 typeld， 不 同 的 数值 代表 了 不 同 的 微 博 列表 类 型 ，0 表 示 获 取 所 有 人 的 微 


户 的 微 博 列 表 ， 其 对 应 的 变量 名 为 $typeld。 第 二 个 参数 是 页 数 ， 由 于 列表 数据 比较 多 ， 所 以 我 们 会 采 


分 页 的 方式 来 获取 ， 其 对 应 变量 名 为 


首先 ， 我 们 来 看 第 一 种 情况 ， 也 就 是 当 $typeld 的 值 等 于 0 时 ， 获 


取 所 有 人 的 微 博 列表 的 逻辑 ， 这 个 接口 是 留 给 客 


端的 微 博 主 界面 使 


。 该 接 


的 逻辑 很 简单 ， 程 序 直接 调 


DAO 类 Core Blog 中 的 


getListByPage 方 法 来 获取 微 博 列表 数据 ， 然 后 组 装 成 JSON 代 码 并 返回 。 


回 


关于 getListByPage 方 法 的 


体 逻 辑 可 参考 代码 清单 6-31。 


代码 清单 6-31 


class Core_Blog extends Demos_Dao_Core 


{ 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


public function getListByPage (SpageId = 0) 
{ 
$list = array(); 
$sql = $this-»select () 
->from($this->t1, '*') 
->order ("{$this->t1}.uptime desc") 
-»limitPage (S$pageId, 10); 
$res = Sthis-»dbr()-»fetchAll ($sql); 
if ($res) { 
ScustomerDao = new Core Customer () ; 
foreach ($res as $row) { 
Scustomer = ScustomerDao->read ($row['customerid']); 
Sblog = array ( 


tig! => $row['id'], 

"face! => Demos_Util_Image: :getFaceUrl (Scustomer['face']), 
"content! => '<b>'.Scustomer['name'].'</b> : '.Srow['content'], 
"comment! => 'GP#it ('.$row['commentcount'].')', 

"uptime" => Srow['uptime'], 


); 
array_push ($list, $blog); 
} 
} 
return $list; 


} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


从 上 述 代码 中 ， 我 们 可 以 看 到 getListByPage 方 法 仅 接收 一 个 参数 ， 那 就 是 页 数 $gpageld 变 量 ， 在 使 用 select 方 法 拼装 查询 语句 时 ， 我 们 需要 特别 注意 一 下 limitPage 方 法 的 使 用 ， 此 方法 在 分 页 查询 时 非 


常 好 用 ， 第 一 个 参数 是 目前 的 页 数 ， 第 二 个 参数 是 每 页 的 记录 条 数 ， 然 后 框架 程序 会 自动 生成 分 页 查询 的 SQL 语句 。 假 设 我 们 要 查询 第 一 页 的 数据 ， 对 应 的 SQL 语句 就 是 “SELECT*FROM blog ORDER BY 


blog.uptime DESC LIMIT 0，10”。 接 着 程序 会 使 用 fetchAll 查 询 出 所 有 微 博 数据 并 存放 到 $res 数 组 变量 中 ， 然 后 使 用 foreach 循 环 语句 取出 每 条 微 博 的 数据 ， 重 新 组 装 并 返 


Core_Customer 中 的 read 方 法 来 获得 ， 其 他 的 几 个 数据 是 微 博 内 容 、 评 论 数 和 发 表 时 间 。 


回 到 blogListAction 方 法 ， 如 果 getListByPage 方 法 返回 的 结果 不 为 空 ， 接 口 就 会 返 


回 


回 ， 比 如 微 博 头像 就 需要 使 


10000 正 确 代 码 ， 并 提示 “Get blog list ok”， 表 明成 功 获取 博客 列表 。 另 外 ， 这 里 我 们 需要 特别 注意 的 是 JSON 


返回 代码 中 result 字 段 所 对 应 的 内 容 ， 这 里 的 Blog.list 表 示 的 就 是 Blog 模 型 对 象 的 列表 ， 具 体 结果 见 代码 清单 6-32， 对 照 getListByPage 方 法 中 所 处 理 的 微 博 字段 ， 我 们 可 以 很 容易 地 理解 这 段 JSON 代 码 。 


代码 清单 6-32 


"code":"10000", 

"message":"Get blog list ok", 

"result":( 

"Blog.list": [ 
{ 

"id":5, 
"face":"http: \/\/localhost:8002\/faces\/default\/face_0.png", 
"content":"<b>james<\/b> : test blog 5", 
"comment" : "Nu8bc4Nu8bba (0) ", 
"uptime":"2012-01-14 21:51:54" 


), 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


] 


介绍 完 获取 所 有 人 的 微 博 列表 的 逻辑 ， 我 们 再 来 看 另外 一 种 情况 ， 也 就 是 当 $typeld 的 值 为 1 时 ， 根 据 用 户 ID ($customerld) 获取 指定 


Core_Blog 中 的 getListByCustomer 方 法 来 获取 微 博 列表 ， 此 方法 的 逻辑 如 代码 清单 6-33 所 示 。 


代码 清单 6-33 


户 微 博 列表 的 逻辑 。 在 这 种 情况 下 ， 我 们 需 


使 用 DAO 类 


class Core Blog extends Demos Dao Core 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public function getListByCustomer ($customerId, $pageld = 0) 7 
{ 
$list = array(); 
$sql = $this—>select () 
->from($this->t1, '*') 
->where ("{$this->t1}.customerid = ?", $customerId) 
->order ("{$this->t1}.uptime desc") 
-»limitPage (S$pageId, 10); 
$res = $this-»dbr()-»fetchAll ($sql); 
if ($res) { 
$customerDao = new Core Customer () ; 
foreach ($res as $row) { 
Scustomer = ScustomerDao->read ($row['customerid']); 
$blog = array( 
fadt => Srow['id'], 
'content' => '<b>'.Scustomer['name'].'</b> : '.$row['content'], 
'comment'-» 'jfie('.$row['commentcount'].')', 
'uptime' => Srow['uptime'], 
); 
array_push ($list, $blog); 
} 
} 
return $list; 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


上 述 方法 的 功能 和 前 面 介绍 的 getListByPage 方 法 比较 类 似 ， 同 样 是 分 页 获取 微 博 列表 ， 只 不 过 多 了 一 个 用 户 ID 的 参数 ($customerld) 。 方 法 中 查询 语句 所 对 应 的 SQL 为 “SELECT*FROM blog 


WHERE blog.customerid=ORDER BY blog.uptime DESC LIMIT 0，10”。 后 面 也 是 取出 每 条 微 博 的 数据 进行 重新 组 装 ， 这 里 的 字段 与 所 有 人 微 博 列表 的 情况 相 比 ， 少 了 一 个 


字段 。 不 过 在 本 方法 的 代码 中 我 们 还 留 下 了 一 个 需要 优化 的 地 方 ， 有 兴趣 的 读者 可 以 尝试 寻找 一 下 ， 具 体 答案 请 参考 9.1.1 节 中 与 优化 PHP 代 码 有 关 的 内 容 。 本 方法 的 JSON 返 回 如 代码 清和 


代码 清单 6-34 


户头 像 字段 ， 也 就 是 face 


6-34 所 示 。 


"code":"10000", 
"message":"Get blog list ok", 
"result": { 
"Blog.list": [ 
{ 
"id": 5, 
"content":"<b>james<\/b> : test blog 5", 
"comment" : "\u8bc4\u8bba (0) ", 
"uptime":"2012-01-14 21:51:54" 
Hh 


http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


我 们 可 以 看 到 这 种 情况 下 的 JSON 返 回 格式 和 所 有 人 微 博 列表 中 的 返回 格式 是 基本 相同 的 ， 不 再 赣 述 。 当 然 ， 如 果 在 以 上 两 种 情况 均 获取 不 到 微 博 列表 信息 的 情况 下 ， 程 序 将 会 返回 14008 错 误 信息 ， 并 
提示 “Get blog list failed" ， 也 就 是 获取 微 博 列表 失败 的 提示 。 获 取 关 注 用 户 的 微 博 列表 功能 在 本 微 博 实例 中 并 未 实现 ， 而 是 当做 一 个 课 后 作业 布置 给 大 家 来 思考 和 实现 。 


65 评论 接口 


为 了 促进 用 户 之 间 的 交流 ， 微 博 应 用 提供 了 评论 功能 ， 用 户 在 阅读 完 微 博 的 具体 内 容 之 后 ， 可 以 发 表 自 己 的 看 法 ， 并 且 这 些 评论 会 以 列表 的 形式 显示 出 来 供 大 家 阅读 。 微 博 的 评论 接口 用 于 微 博 详情 界 
面 ， 其 主要 功能 就 是 创建 评论 和 获取 评论 列表 。 我 们 根据 功能 特点 把 评论 接口 都 归 类 到 CommentServer 控 制 器 下 。 


6.5.1 发 表 评论 接口 


发 表 评 论 接口 用 于 用 户 在 微 博 详情 界面 点 击发 表 评论 时 ， 此 接口 的 作用 很 单一 ， 就 是 给 对 应 的 博客 发 表 评论 ， 接 口 逻 辑 见 代码 清单 6-35。 


代码 清单 6-35 


class CommentServer extends Demos_App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
* 


- 
* 


> 接口 说 明 : 发 表 评论 接口 

<code> 

URL 地 址 : /comment/commentCreate 

提交 方式 : POST 

参数 #1: blogId, X9: INT， 必 须 : YES 
参数 #2: content， 类 型 : STRING， 必 须 : YES 
</code> 


* ROO OF 


* 


Gtitle 发 表 评 论 接口 

@action /comment/commentCreate 
@params blogId 0 INT 

@params content '' STRING 
@method post 


* ROO * * 
~ 


public function commentCreateAction () 

{ 
Sthis->doAuth () ; 
$blogId = intval(S$this-»param('blogId')); 
$content = $this-»param('content'); 
// 查找 Blog 是 否 已 存在 ， 若 不 存在 则 返回 错误 代码 10009 
$blogDao = $this->dao->load('Core_Blog'); 
if (!$blogDao-»exist(SblogId)) { 

$this->render('10009', 'Blog not exist'); 


} 

if (SblogId && $content) { 
$commentDao = $this->dao->load('Core_Comment') ; 
$commentDao->create (array ( 


'blogid' => $blogld, 
'customerid' => Sthis-»customer['id'], 
"content! => Scontent 


)); 
// 保存 Blog 的 评论 ， 并 返回 正确 代码 10000 
$blogDao->addCommentcount ($blogId) ; 
S$this-»render('10000', 'Create comment ok'); 
} 
$this-»render('14011', 'Create comment failed'); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


发 表 评 论 接口 和 发 表 微 博 接口 的 逻辑 有 点 类 似 ， 只 不 过 发 表 微 博 接口 中 只 需要 接收 微 博 的 内 容 ， 而 在 发 表 评 论 接口 中 除了 需要 接收 评论 的 内 容 之 外 还 需要 接收 对 应 微 博 的 ID， 因 为 评论 必然 针对 某 条 微 


博 。 


首先 ， 程 序 逻 辑 会 根据 微 博 的 ID 来 判断 该 微 博 是 否 存在 ， 这 里 使 用 的 是 DAO 类 Core_Blog 中 的 exist 方 法 ; 当然 ， 如 果 微 博 不 存在 就 会 直接 返回 10009 错 误 ， 错 误 信息 为 “Blog not exist”， 也 就 是 微 博 
不 存在 。 之 后 ， 如 果 博 客 ID 和 评论 内 容 都 存在 ， 则 调用 DAO 类 Core _ Comment 中 的 create 方 法 来 向 对 应 的 comment 表 中 插入 数据 ， 至 于 create 方 法 的 使 用 前 面 已 经 提 到 过 很 多 次 了 ， 不 再 乾 述 。 不 过 之 后 
的 Core_Blog 中 的 addCommentcount 方 法 还 是 需要 提 一 下 ， 此 方法 的 逻辑 如 代码 清单 6-36 所 示 。 


a 


UE 6-36 


class Core Blog extends Demos Dao Core 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function addCommentcount ($id, $addCount = 1) 
{ 
Sblog = $this->read ($id); 
Sblog['commentcount'] = $blog['commentcount'] + $addCount; 
$this->update ($blog); 


š 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


此 方法 用 于 更 新 微 博 表 中 存储 微 博 评论 数 的 元 余 字 段 commentcount， 实 现 逻 辑 和 之 前 介绍 过 的 Core Customer 类 中 的 addFanscount 方 法 ( 见 代 码 清单 6-22) 和 addBlogcount 方 法 ( 见 代 码 清单 6- 
27) 非常 类 似 ， 当 该 方法 成 功 执行 之 后 ， 整 个 发 表 评论 的 逻辑 就 结束 了 ， 接 口 方法 会 返回 10000 成 功 消息 ， 并 提示 “Create comment ok”， 即 “成 功 创建 评论 。。 反 之 则 返回 14011 错 误 消息 ， 提 
示 “Create comment failed”， 即 “创建 评论 失败 ”。 


6.5.2 ”评论 列表 接口 


在 微 博 详情 界面 中 ， 微 博 的 评论 信息 就 是 从 评论 列表 接口 获取 的 。 该 接口 的 功能 逻辑 和 6.4.3 节 中 的 “ 微 博 列表 接口 ”比较 相似 ， 接 口 逻 辑 参考 代码 清单 6-37。 


代码 清单 6-37 


class CommentServer extends Demos_App_ Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
J** = 


* > 接口 说 明 : 评论 列表 接口 


* <code> 


* URIL 地 址 : /comment/commentList 

* 提交 方式 : GET 

* 参数 #1: blogTd， 类 型 : INT， 必 须 : YES 
* 

* 


参数 #2: pageId， 类 型 : INT， 必 须 : 
</code> 

* @title 评论 列表 接口 

* @action /comment/commentList 

* @params blogId 0 INT 

* @params pageId 0 INT 

* @method get 

ui 

public function commentListAction () 


{ 


* 


Sthis-»doAuth(); 
SblogId = intval(Sthis-»param('blogId')); 
$pageld = intval(Sthis-»param('pageld')); 
ScommentDao = $this->dao->load('Core Comment'); 
$commentList = $commentDao-»getListByBlog ($blogId, $pageld) ; 
if ($commentList) { 
$this->render('10000', 'Get comment list ok', array ( 
'Comment.list' => $commentList 
); 
} 
$this-»render('14010', 'Get comment list failed'); 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


评论 列表 接口 的 对 应 方法 名 为 commentListAction， 对 应 API 接口 的 URL 地 址 为 /comment/commentList。 此 接口 支持 分 页 返 
之 后 就 会 调用 DAO 类 Core Comment 中 的 getListByBlog 方 法 从 comment 表 中 获取 所 需 的 评论 信息 ， 方 法 逻辑 参考 代码 清单 6-38。 


回 


列表 型 数据 ， 程 序 获取 完 微 博 ID ($blogld) 和 当前 页 码 ($pageld) 


代码 清单 6-38 


class Core Comment extends Demos_Dao_Core 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function getListByBlog ($blogId, $pageId = 0) 
{ 
$list = array(); 
$sql = $this->select () 
->from($this->t1, '*') 
->where ("{$this->t1l}.blogid = ?", $blogId) 
->order ("{$this->tl} .uptime desc") 
-»limitPage ($pageId, 10); 
$res = Sthis-»dbr()-»fetchAll ($sql); 
if ($res) { 
ScustomerDao = new Core Customer () ; 
foreach ($res as $row) { 
Scustomer = ScustomerDao->read ($row['customerid']); 
Scomment = array ( 


'id' => Srow['id'], 
"content! => '<b>'.Scustomer['name'].'</b> : '.Srow['content'], 
"uptime" => Srow['uptime'], 


); 
array_push($list, $comment); 
} 
l 
return $list; 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


Core Comment 类 中 的 getListByBlog 方 法 接收 两 个 参数 ， 分 别 是 微 博 ID 和 当前 页 码 ， 此 方法 的 处 理 方式 和 Core_Blog 类 中 的 getListByPage 方 法 〈 见 代码 清单 6-31) 比较 类 似 ， 同 样 是 通过 select 方 法 
拼装 SQL 语句 来 执行 。 假 如 此 时 $pageld 的 值 为 0 或 者 1， 也 就 是 位 于 首页 时 ， 此 时 解析 出 来 的 SQL 为 “SELECT*FROM comment WHERE comment.blogid=ORDER BY comment.uptime DESC LIMIT 
0，10”。 获 取 到 评论 信息 列表 之 后 ， 同 样 使 用 foreach 循 环 语句 把 单条 评论 信息 获取 出 来 ， 并 重新 拼装 整合 ， 最 后 得 到 与 Comment 模 型 相符 的 数组 列表 。 


回 到 接口 方法 的 逻辑 ， 如 果 能 成 功 获取 到 评论 列表 ， 程 序 就 会 返回 Comment 对 象 列表 ，JSON 返 回 如 代码 清单 6-39 所 示 ; 则 返回 14010 错 误 信息 ， 并 提示 “Get comment list failed”， 即 获取 评 
论 列表 失败 。 


代码 清单 6-39 


"code":"10000", 
"message" :"Get comment list ok", 
"result": { 


"Comment.list": [ 
{ 
"TH 5; 
"content" :"<b>james<\/b> : comment by james", 
"uptime":"2012-04-12 15:00:55" 
http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


Ej 


上 述 JSON 数 据 是 评论 列表 的 返回 样 例 ，Comment.list 表 示 这 里 的 列表 是 Comment 模 型 的 对 象 列 表 ， 包 含 评论 ID (id) 、 评 论 内 容 (content) 和 评论 时 间 (uptime) 三 个 字段 ， 当 然 这 些 字 段 与 前 
getListByBlog 方 法 中 的 返回 数据 的 字段 必须 是 一 致 的 。 


回 


6.6 图片 接口 


IR] 


顾名思义 ,图片 接口 被 设计 用 于 处 理 所 有 与 图 片 功能 有 关 的 逻辑 。 对 于 现在 的 互联 网 应 用 来 说 ， 图 片 相关 功能 已 经 上 升 到 了 一 个 非常 重要 的 地 位 ; Q 是 因为 图 片 比 文字 形象 ， 能 很 好 地 提升 产品 的 
体验 度 。 就 拿 微 博 应 用 来 说， 很 多 地 方 都 需要 用 到 图 片 ， 比 如 换 头 像 功能 需要 选择 头像 图 片 ， 微 博 列表 也 需要 读 取 所 需 图 片 等 。 本 书 的 微 博 实例 中 ， 图 片 部 分 的 功能 主要 偏重 于 用 户头 像 部 分 的 内 容 ， 相 关 
图 片 接口 包含 了 获取 头像 列表 和 获取 用 户头 像 两 个 接口 ， 而 这 些 接口 都 被 存放 在 lImageServer 控 制 器 中 。 


D 
D 


D 
D 


6.6.1 ”用户 头像 接口 


微 博 应 用 中 很 多 地 方 都 会 用 到 用 户 的 头像 ， 比 如 微 博 列表 界面 中 每 条 微 博 前 面 都 会 显示 对 应 微 博 的 作者 头像 ， 而 微 博 详情 界面 中 也 会 显示 当前 微 博 的 作者 头像 等 。 该 接口 仅 接 收 一 个 参数 ， 也 就 是 头 人 
的 ID (参数 名 faceld) ， 不 过 该 参数 支持 两 种 表示 方法 : 如 果 只 需要 获取 单个 用 户头 像 ， 只 需要 传 入 该 用 户 的 头像 |D 即 可 ; 而 假如 要 一 次 获取 多 个 头像 ， 可 以 传 入 由 多 个 头像 |D 组 合成 的 字符 串 〈 中 间 用 ji 
号 隔 开 ) 。 该 接口 的 逻辑 如 代码 清单 6-40 所 示 。 


ki 


代码 清单 ”6-40 


class ImageServer extends Demos_App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


[** 


* 


«code» 


提交 方式 : GET 
参数 #1: faceld, 
</code> 


HF OF OF 


> 接口 说 明 : 查看 用 


URL 地 址 : /image/faceView 


类 型 : STRING， 必 须 : YES 


Gtitle 查看 用 户头 像 接 口 


Gparams faceld 


* 
* (action /image/ 
* 

* @method get 


faceView 
0 STRING 


public function faceViewAction () 


{ 
$faceldStr 
$faceldArr 
// 单个 头像 


$this->param('faceId'); 


SfaceldStr ? explode(',', $this->param('faceId')) : array(); 


if ($faceCount == 1) { 


$facel 
$facel 
$this- 


)); 
// 多 个 头像 


d = intval ($faceIdArr[0]); 

tem = Demos Util Image: :getFaceImage ($faceId); 
»render('10000', 'Get face ok', array( 

'Image' => $faceltem 


} elseif ($faceCount > 1) { 
$faceList = array(); 


foreac! 


} 
$this- 


)); 
} else { 
$this- 
l 


)http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


h (SfaceIdArr as $faceId) { 
$faceList[] = Demos Util Image: :getFacelmage ($faceld); 


»render('10000', 'Get face list ok', array( 
'Image.list' => $faceList 


»render('14012', 'Get face failed'); 


获取 用 户头 像 接口 的 方法 为 faceViewAction， 接 口 地址 为 /image/faceView。 首 先 ， 程 序 使 用 explode 方 法 把 传 入 的 单个 或 者 多 个 
后 ， 程 序 会 根据 参数 的 个 数 把 两 种 不 同 逻辑 分 开 处 理 : 假如 接收 到 的 


所 示 ; 如 果 传 入 的 


小 贴 士 : PHP 中 的 explode 方 法 常用 于 分 割 字 符 串 并 将 结果 存储 到 数组 中 。 该 方法 中 的 第 一 个 参数 是 用 于 分 割 的 间隔 字符 ， 比 如 这 里 我 们 使 用 的 就 是 去 号 ; 而 第 二 个 


本 接口 中 就 是 头像 ID 的 组 合 字符 串 。 与 之 相对 的 是 implode 方 法 ， 用 于 把 数组 拼装 成 字符 串 。 


代码 清单 6-41 


"code":"10000", 
"message": "Get fac 
"result": { 
"Image": { 
nidh: p, 
marimii 
"type": "pi 


e ok", 


tp:\/\/localhost : 8002\/faces\/default\/face_0.png", 
ng" 


户头 像 ID 分 解 出 来 并 存放 到 一 个 头像 数组 (SfaceldArr) 中 。 然 


户头 像 |D 只 有 一 个 ， 也 就 是 获取 单个 用 户头 像 ， 程 序 逻辑 会 获取 头像 图 片 的 信息 并 返回 单个 Image 对 象 ，JSON 返 回 如 代码 清单 6-41 
户头 像 ID 不 止 一 个 ， 也 就 是 获取 多 个 用 户头 像 ， 程 序 逻辑 会 使 用 foreach 循 环 来 逐个 获取 头像 图 片 的 信息 并 返回 image 对象 数 组 ，JSON 返 


回 


见 代码 清单 6-42。 


参数 则 是 准备 用 于 分 割 的 字符 串 ， 在 


代码 清单 6-41 是 获取 单个 
址 ，type 是 图 片 的 类 型 。 当 然 ， 


代码 清单 6-42 


户头 像 时 的 JSON 返 回 代码 ， 我 们 可 以 看 到 result 结 果 字 段 中 包含 的 是 单个 Image 模 型 的 对 象 数 拉 
该 模型 对 象 和 客户 端 Image 模 型 中 的 属性 是 一 致 的 ， 这 样 在 客户 端 获取 到 数据 之 后 就 可 以 解析 并 


居 。lmage 模 型 包含 3 个 字段 : id 是 头像 的 ID 编号 ，url 是 图 像 的 URL 地 


"code":"10000", 


"message":"Get face list ok", 


"result": { 
"Image.list" 


EO 


"ign" 
"url": "http: \/\/localhost :8002\/faces\/default\/face_0.png", 


http: \/\/localhost :8002\/faces\/default\/face_1.png", 
een: 


http: \/\/localhost :8002\/faces\/default\/face 2 .png", 


"type":"png" 


代码 清单 6-42 是 获取 多 个 


不 小 的 作用 。 此 外 ， 获 取 头 像 的 


代码 清单 。6-43 


class Demos Util Image 


{ 


[** 


Fitz T E3ÉDemos Util_ImagePAIgetFacelmageAik, SCHISM ia 


6-43 所 示 。 


* 获取 头像 图 片 的 URL 地 址 


* @param int $id 
*/ 


public static function getFaceUrl ($id) 


{ 
$facePath = 


return $facePath . '/face ' . $id. 


} 


/** 


HOST WEBSITE . '/faces/default'; 


'.png'; 


* 获取 头像 图 片 的 对 象 


* @param int $id 


*/ 


public static function getFaceImage ($id) 


{ 


return array 


( 


'id' => $id, 


户头 像 时 的 JSON 返 回 代码 ， 我 们 可 以 看 到 这 里 的 result 字 段 中 包含 的 是 Image 模 型 对 象 数组 ， 这 种 合并 返回 的 方式 可 以 有 效 地 减少 HTTP 请 求 数 ， 对 系统 运行 效率 的 提升 有 


'url' => self::getFaceUrl ($id), 
‘type! => 'png', 
); 


以 上 是 整个 Demos_Util Image 工具 类 的 代码 ， 此 类 中 的 getFacelmage 方 法 在 之 前 的 6.3.3 节 和 6.4.3 节 中 都 被 使 用 到 ， 此 方法 返回 的 是 Image 模 型 数据 。 这 里 我 们 需要 注意 的 是 ， 图 片 地 址 是 使 
getFaceUr| 方 法 来 获取 的 ，getFaceUr| 方 法 比较 简单 ， 就 是 根据 配置 拼装 出 对 应 图 片 的 URL 地 址 ， 这 里 我 们 需要 注意 的 是 _HOST_ WEBSITE 常 量 的 意义 ， 此 常量 表示 的 是 微 博 应 用 中 Web 站 点 域名 ， 其 相关 
配置 代码 在 etc/app.config.php 应 用 配置 文件 中 可 以 找到 ， 此 站 点 目录 放置 的 是 Web 网 站 的 逻辑 以 及 可 访问 的 静态 文件 ， 比 如 用 户头 像 图 片 ， 对 应 本 地 目录 为 www/website/faces/default/。 此 外 ， 在 应 
配置 文件 中 我 们 还 可 以 找到 另 一 个 类 似 的 常量 _HOST_SERVER， 此 常量 代表 的 是 微 博 应 用 中 API 接 口 站 点 的 域名 ， 在 调试 框架 程序 逻辑 中 经 常用 到 。 


回 到 faceViewAction 接 口 方法 逻辑 ， 在 没有 获取 到 任何 头像 结果 时 ， 接 口 会 返回 14012 错 误 代 码 ， 并 返回 提示 信息 “Get face failed”， 即 获取 头像 失败 。 


6.6.2 ”头像 列表 接口 


头像 列表 接口 用 于 用 户 配置 界面 中 的 选择 头像 功能 。 该 接口 功能 比较 简单 ， 不 需要 任何 参数 。 该 接口 返回 的 是 用 户头 像 列 表 所 对 应 的 lImage 模 型 对 象 列表 ， 实 现 逻 辑 如 代码 清单 6-44 所 示 。 


代码 清单 ”6-44 


class ImageServer extends Demos_App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
/x = 


* 


* > 接口 说 明 : 头像 列表 接口 
* <code> 
* URL 地 址 : /image/faceList 
* 提交 方式 : GET 
* </code> 
LI M 
* Qtitle 头像 列表 接口 
* @action /image/faceList 
* @method get 
ui 
public function faceListAction () 
{ 
// 设置 头像 图 片 ID 
$faceIdArr = range(0,14); 
// 获取 头像 图 片 
Sfacelist = array(); 
foreach ($faceIdArr as $faceId) { 
$faceList[] = Demos_Util_Image: :getFaceImage ($faceId) ; 


] 

$this-»render('10000', 'Get face list ok', array( 
'Image.list' => $faceList 

)); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
) 


头像 列表 接口 的 方法 名 为 faceListAction， 对 应 接口 地 址 为 /image/faceList。 此 接口 的 逻辑 很 简单 ， 就 是 把 头像 ID 从 0 到 14 的 15 张 头像 图 片 对 应 的 Image 模 型 对 象 返回 给 客户 端 展示 ， 以 供用 户 选择 头 
像 。 当 然 ， 这 里 也 使 用 到 了 工具 类 Demos_Util Image 中 的 getFacelmage 方 法 ， 其 具体 使 用 方法 不 再 歼 述 。 此 接口 的 返回 JSON 代 码 见 代码 清单 6-45。 


代码 清单 6-45 


"code":"10000", 
"message":"Get face list ok", 
"result": { 


"Image. list": [ 


"id":0, 
"url": "http: \/\/localhost :8002\/faces\/default\/face_0.png", 
"type": "png" 
] 
{ 
"id" :1, 
"url": "http: \/\/localhost:8002\/faces\/default\/face_1.png", 
“type”: "png" T 
] 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
{ 
"id":14, 
"url": "http: \/\/localhost :8002\/faces\/default\/face_14.png", 
"type": "png" 


6.63 ”图 片上 传 接口 


为 了 使 发 布 的 微 博信 息 更 加 吸引 人 ， 我 们 在 发 表 微 博 的 功能 中 加 入 上 传 图 片 的 功能 。 实 际 上 ， 我 们 在 项 目 中 也 经 常会 遇 到 上 传 文件 的 需求 。 在 这 种 场景 中 ， 服 务 器 的 任务 其 实 很 简单 ， 那 就 是 接收 从 客 
户 端 传 过 来 的 文件 ， 然 后 保存 下 来 并 记录 到 数据 库 中 去 。 


我 们 之 前 在 6.4.1 节 中 已 经 给 大 家 分 析 过 发 表 微 博 接口 的 实现 逻辑 ， 其 实 要 实现 图 片上 传 功能 只 需要 略微 修改 一 下 发 表 微 博 接口 blogCreateAction 即 可 ， 实 现 逻 辑 见 代码 清单 6-46。 


代码 清单 ”6-46 


class BlogServer extends Demos_App Server 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
f** nd 


* > 接口 说 明 : 发 表 徽 博 接口 

* <code> 

* URL 地 址 : /blog/blogCreate 

* 提交 方式 : POST 

* 参数 #1: content， 类 型 : STRING， 必 须 : YES 
* </code> 

* @title 发 表 微 博 接口 

* @action /blog/blogCreate 

* @params content '' STRING 

* @method post 


public function blogCreateAction () 
{ 
$this—>doAuth () ; 
$content = $this—>param('content') ; 


http: 
] 


以 上 代码 中 ， 我 人 
的 文件 数据 ， 假 设 文件 表单 的 参数 名 为 file0， 那 么 服务 器 就 要 通过 $_FILES['file0"] 变 量 来 获取 上 传 文件 的 信息 ， 


- $_FILES 
- $ FILES 
- $ FILES 
- $_FILES 
- $ FILES 


PHP 服 务 端 接收 上 传 文件 完毕 之 后 ， 会 在 服务 器 上 创建 一 个 临时 文件 ， 这 个 文件 地 址 就 被 保存 到 了 $ _FILES[file0][tmp_name'] 变 量 里 面 ; 


if ($content) { 
// KE SA 
$upload file url = ''; 
Supload_err = $ FILES['fileO']['error']; 
$upload file = $ FILES['fileO']['tmp name']; 
Supload file name = $ FILES['fileO']['name']; 
if (S$upload file name) { 
S$upload file ext = pathinfo($upload file name, PATHINFO EXTENSION); 
if ($upload err == 0) ( T 
$upload face dir = _ PICTURE DIR . '/'; 
Supload file name = md5 (time() . rand (123456, 999999) ) ; 
$upload file path = $upload face dir . $upload file name . 
'.' . Supload file ext; 
if (!move_uploaded_file (Supload file, Supload file path)) { 
Sthis-»render('14010', 'Create blog failed"); 
} else { 
Supload file url = $upload file name . '.' 


. Supload_file_ext; 
} 

} else { 
$this-»render('14011', 'Create blog failed'); 


} 


} 

// 保存 微 博 内 容 

SblogDao = Sthis->dao->load('Core Blog'); 
$blogDao->create (array ( 


'customerid' => Sthis-»customer['id'], 

'desc" => "'', 

'title' = or 

"content! => $content, 

"picture! => $upload file url, // 保存 上 传 图 片 
'commentcount ' => 0 


) ) 7 
// 更 新 用 户 微 博 数量 ( 详 见 6.4.1 节 ) 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


//www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


] 省 去 了 保存 微 博 内 容 的 逻辑 ， 大 家 有 


点 关注 服务 器 接收 


片 并 保存 的 逻辑 。 首 先是 预定 义 变量 $_FILES 的 有 


法 ， 一 般 来 说 ，PHP 服 务 端 都 是 通过 HTTP 的 POST 方法 来 接收 由 客户 端 传 来 


以 下 是 几 种 常 上 


file0][name']: 原始 文件 名 


'file0'][type']: 文件 类 型 ， 比 如 “image/gif” 


‘fileO']['size']: 文件 大 小 ， 单 位 是 bytes 


file0][tmp_name']: 上 传 到 服务 器 的 临时 文件 


'file0']['error']: 上 传 过 程 中 出 现 的 错误 信息 


的 文件 信息 。 


此 我 们 检 


完 上 传 文件 的 信息 之 后 ， 就 可 以 使 


move uploaded file ($upload file, $upload file path) 方法 把 临时 文件 保存 到 对 应 的 文件 目录 了 ， 也 就 是 _PICTURE_DIR， 大 家 可 以 到 etc/app.config.php 中 查看 该 变量 的 值 ， 实 际 上 就 


是 www/website/picture 


3X. 


当然 ， 从 前 面 的 代码 中 我 们 还 可 以 学 习 到 如 何 使 用 pathinfo 函 数 获取 文件 扩展 名 ， 以 及 如 何 使 
表 接 口 ， 把 微 博 图 片 的 信息 返回 给 客户 端 ， 见 代码 清单 6-47。 


代码 清单 6-47 


时 间 惟 函数 (time) 和 随机 函数 (rand) 来 生成 随机 文件 名 的 


法 。 最 后 ， 我 们 还 要 稍微 修改 下 微 博 列 


class 

{ 

http: 
Z 


BlogServer extends Demos_App Server 


/ /www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
** 


* 


> 接口 说 明 : 微 博 列 表 接口 

<code> 

URL 地 址 : /blog/blogList 

提交 方式 : GET 

参数 #1: typeId， 类 型 : INT， 必 须 : YES 
参数 #2: pageId， 类 型 : INT， 必 须 : YES 
</code> 

@title 微 博 列表 接口 

@action /blog/blogList 

Gparams typeld 0 0: 全 部 ，1: AU, 2: 关注 
@params pageId 0 INT 

@method get 

*/ 


public function blogListAction () 


{ 


} 
http: 
l 


$this-»doAuth(); 
// 获取 微 博 列表 信息 到 SblogList 变 量 ( 详 见 6.4.3 节 ) 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


if ($blogList) { 
// 拼装 微 博 图 片 真实 的 网 络 地 址 
foreach (SblogList as &$row) { 
if (strlen($row['picture']) > 0) { 
$row['picture'] = _ PICTURE URL . $row['picture']; 
} 
} 
$this->render ('10000', 'Get blog list ok', array( 
'Blog.list' => $blogList 
Ye 
} 
$this-»render('14008', 'Get blog list failed"); 


/ /www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


Zit, 


网 


片上 传 功能 的 服务 器 端 就 介绍 完毕 了 ， 后 面 我 们 将 会 在 7.9.5 章 节 中 为 大 家 介绍 如 何 使 用 Android 客 户 端 选 择 本 地 | 


网 


片 并 上 传 。 


6.7 ”通知 接口 


在 本 书 的 微 博 实例 中 ， 我 们 提供 了 实时 通知 的 功能 ， 一 方面 是 为 了 完善 微 博 实例 的 功能 ， 另 一 方面 是 为 了 支持 Android 客 户 端 Service 服 务 的 实例 。 通 知 接口 
获取 通知 这 一 个 接口 


的 控制 器 类 名 为 NotifyServer， 目 前 只 包含 


假如 获 


获取 通知 接口 


获取 通知 接口 是 提供 给 客户 端的 通知 服务 (NoticeService) 来 调用 的 ， 接 


代码 清单 ”6-48 


class NotifyServer extends Demos App Server 


口 实现 见 代码 清和 


messe. 


6-48。 按 照 这 部 分 功能 的 设计 ， 
到 消息 内 容 则 发 送 通知 (Notification) 到 移动 设备 。 关 于 此 功能 中 客户 端 部 分 的 实现 4 


参考 7.5.4 节 的 内 容 。 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


/** 


* 


* > 接口 说 明 : 获取 通知 接口 
* <code> 

* URIL 地 址 : /notify/notice 
* 提交 方式 : POST 

* </code> 


* @title 获取 通知 接口 
* @action /notify/notice 
* @method get 
*/ 
public function noticeAction () 
{ 
Sthis-»doAuth(); 
// 根据 ID 获取 用 户 信息 


$noticeDao = $this->dao->load('Core Notice"); 


$noticeItem = $noticeDao->getByCustomer ($this-»customer['id']); 


if ($noticeItem) { 
SnoticeDao->setRead ($this-»customer['id']); 
Sthis-»render ('10000', 
'Notice' => SnoticeItem 


)); 


} 
$this-»render('14013', 'Get notification failed'); 


'Get notification ok', array( 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


获取 通知 接口 的 方法 名 为 noticeAction， 对 应 API 接 


序 会 调 


$e, 
89 


' 


信息 ， 比 如 “L ('cn', 'notice', ...) 


DAO 类 Core_Notice 中 的 getByCustomer 方 法 来 获取 指定 


代码 清单 6-49 


class Core Notice extends Demos_Dao_Core 


户 的 消息 ， 


地 址 为 /notify/notice， 该 接口 不 需 


接收 任何 参数 ， 因 为 我 们 可 以 从 session 会 话 中 直接 获取 到 


此 方法 的 逻辑 如 代码 清单 6-49 所 示 。 


客户 端的 通知 服务 每 隔 30 秒 就 会 来 服务 端的 获取 通知 接口 获取 通知 消息 ， 


户 的 信息 。 当 然 ， 在 获取 到 


户 信息 之 后 ， 程 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


public function getByCustomer ($customerId) 
{ 
$sql = $this->select ()->from($this->t1, 
—>where ("customerid = ?", $customerId) 
—>where ("Status = 0"); 
$row = $this->dbr () ->fetchRow ($sql); 
$msg = trim($row['message']); 
// 消息 不 为 空 ， 则 返回 消息 
if (strlen($msg) > 0) { 
return $row; 


tk!) 


l 

// 默认 返回 粉丝 数 消息 

$fans = intval ($row['fanscount']); 

if ($fans > 0) { 
$row['message'] = 
return $row; 


Lien’ 


l 
// 返回 空 信 息 
return null; 


} 


'notice', $row['fanscount']); 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


Core_Notice 类 中 getByCustomer 方 法 的 逻辑 并 不 复杂 。 首 先 ， 从 notice 表 中 取出 status 为 0 的 数 


RIT (0 表示 未 读 ) 。 然 后 ， 判 断 数据 行 中 的 message 字 段 是 否 为 空 ， 若 不 为 空 就 优先 返回 message 数 


若 为 空 则 在 message 字 有 段 填 上 新 粉丝 消息 的 文字 。 当 然 ， 目 前 系统 中 出 现 的 都 是 message 为 空 的 情况 。 另 外 ， 这 里 还 需要 注意 的 是 L (Language 的 缩写 ) 方法 的 用 法 ， 此 方法 是 用 于 获取 应 用 文本 信息 


这 也 是 本 框架 “国际 化 ”功能 的 重要 组 成 部 分 。 
”。 项 目 中 的 


H 


代码 清单 6-50 


此 方法 中 的 前 两 个 参数 是 必须 有 的 ， 分 别 代表 所 处 国家 和 文本 信息 的 标识 ( 
际 化 的 文本 配置 文件 是 etc/global.message.php， 如 代码 清单 6-50 所 示 。 


于 替换 文本 信息 里 面 的 动态 


于 代表 是 哪 条 文本 信息 ) ， 后 面 的 参数 都 是 


$ Lang['cn'] = array( 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


"notice" 


=> "你 有 {0]} 个 新 粉丝 ， 请 速 回 查看 : ) ', 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


); 


5, 


以 上 配置 文件 位 于 应 


回 到 noticeAction 方 法 ， 在 获取 到 通知 消息 之 后 ， 我 们 还 需要 做 一 个 动作 ， 那 就 是 把 这 条 消息 标记 成 已 读 。 这 个 逻辑 需 


B6-51, 


代码 清单 6-51 


配置 目录 etc/ 下 的 global.message.php 中 ， 使 用 “{ 参 数 号 }” 来 代替 需要 替换 的 参数 ， 这 种 做 法 有 点 类 似 于 Java 项 
getByCustomer 的 逻辑 和 Core_Notice 类 中 的 另 一 个 方法 有 比较 紧密 的 联系 ， 也 就 是 addFanscount 方 法 ， 此 方法 在 之 前 的 6.3.4 节 中 的 添加 粉丝 接 
notice 表 中 的 通知 信息 。 


中 的 properties 文 件 ， 应 该 比较 容易 理解 。 此 
中 曾经 提 及 ， 作 用 是 当 用 户 粉 丝 数 发 生变 化 时 更 新 


通过 DAO 类 Core_Notice 中 的 setRead 方 法 来 操作 ， 此 方法 的 逻辑 可 参考 代码 


class Core Notice extends Demos_Dao_Core 


{ 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


public function setRead (S$customerId) { 
$sql = Sthis->select ()->from($this-—>t1, 
—>where ("customerid = ?", $customerId) 
—>where ("Status = 0"); 
$row = $this—>dbr () ->fetchRow ($sql); 
if ($row) { 
$this-»update (array ( 
rid’ 
'status' 


tk!) 


=> intval ($row['id']), 
= 1 
)); 
l 
} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


) 


在 设置 完 消息 已 读 标 志 之 后 ， 获 取 通 知 接口 的 逻辑 就 已 经 完成 了 ， 代 码 清单 6-52 就 是 一 个 完整 返回 的 示例 ， 我 们 可 以 注意 到 result 字 段 里 面包 含 了 一 个 Notice 模 型 对 象 ， 该 对 象 的 消息 提示 内 容 是 “你 


有 1 个 新 粉丝 ， 请 速 回 查看 : ) ”， 也 就 是 我 们 在 global.message.php 中 配置 的 文本 信息 。 


代码 清单 6-52 


"code":"10000", 
"message" :"Get notification ok", 
"result": { 

"Notice": { 


id":2, 
"message" :" 你 有 1 个 新 粉丝 ， 请 速 回 查 看 : ) " 
} 


此 外 ， 在 获取 不 到 未 读 消息 的 情况 下 ， 程 序 都 会 返回 14013 错 误 消息 ， 提 示 为 “Get notification failed”， 即 “获取 通知 失败 ”， 如 代码 清单 6-53 所 示 。 


代码 清单 6-53 


"code":"14013", 
"message": "Get notification failed", 
"result";"" 


68 Web 版 接口 


中 去 ， 此 类 页 面 我 们 称 之 为 “Web 版 接口 ”。 本 书 的 微 博 实例 也 提供 了 几 个 Web 版 接口 作为 示例 ， 下 面 我 们 来 逐个 分 析 一 下 。 


在 传统 的 Android 应 用 开发 思路 中 ， 服 务 端 负责 逻辑 处 理 ， 客 户 端 负责 界面 展示 ， 也 就 是 我 们 之 前 所 介绍 的 方式 。 但 是 实际 上 ，Android 应 用 框架 还 支持 另外 一 种 开发 模式 ， 也 就 是 把 网 页 直接 嵌入 到 应 


首先 我 们 需要 知道 ， 之 前 我 们 介绍 的 API 接 口 的 站 点 地 址 是 http://127.0.0.1: 8001 ( 详 见 应 用 配置 文件 etc/app.config.php) ， 而 Web 版 接口 的 站 点 地 址 则 是 http://127.0.0.1: 8002 (只 是 端口 不 


同 ) ， 其 脚本 文件 的 存放 位 置 ( 即 Apache 的 站 点 目录 ) 和 API 接口 也 不 一 样 ， 是 存放 在 www/website/ 目 录 之 下 的 。 另 外 ，Web 版 接口 不 需要 通过 调试 接口 来 访问 ， 我 们 打开 浏览 器 输入 URL 地 址 即 可 ， 比 


如 我 们 直接 输入 站 点 地 址 就 可 以 打开 默认 首页 index.php 文 件 ， 效 果 如 图 6-5 所 示 。 


| 127.0.0.1:8002 


Test Callback 


jQuery Mobile 
Map Demo 


图 6-5 Web 版 接口 页 面 


我 们 可 以 看 到 首页 中 有 5 个 链接 ， 前 面 3 个 是 给 Android 客 户 端 回调 测试 用 的 ， 这 部 分 内 容 请 参考 7.11.4 节 ; 后 面 2 个 分 别 是 “网 页 界面 示例 ”和 “网 页 地 图 示例 ”的 入 口 链接 ， 下 面 我 们 分 别 来 介绍 一 


下 。 


6.8.1 Web 版 UI 界面 (jQuery Mobile) 


对 于 网 页 形式 的 Android 应 用 开发 来 说 ， 大 部 分 的 界面 是 以 HTML 标 签 来 编写 的 。 虽然 手机 版 的 HTML 的 大 部 分 用 法 和 网 页 中 的 HTML 是 一 样 的 ， 但 是 ， 还 是 有 很 多 细节 需要 我 们 在 实际 开发 过 程 中 慢 慢 


理解 掌握 ， 特 别 需要 注意 的 是 多 种 设备 、 多 种 浏览 器 之 间 的 兼容 性 问题 。 由 于 篇 幅 原 因 ， 本 书 只 会 对 网 页 版 移动 应 用 开发 这 部 分 内 容 做 简单 介绍 ， 以 下 是 最 基本 的 HTML 页 面 模板 的 样 例 ， 如 代码 清单 6-54 
所 示 。 


代码 清单 6-54 


<!DOCTYPE html> 
<html> 
<head> 
<meta charset-"utf-8"» 
«meta name-"viewport" content-"user-scalable-no, width=device-width, initial-scale=1.0"> 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
</head> 
<body> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</body> 
</html> 


在 开发 过 程 中 ， 大 部 分 的 网 页 界面 都 会 套用 以 上 的 HTML 模 板 来 进行 开发 ， 该 模板 的 语法 和 框架 比较 简单 ， 读 者 可 以 自学 并 理解 。 另 外 ， 在 上 面 的 页 面 模板 样 例 中 ， 需 要 注意 两 个 meta 标 签 的 意义 ， 第 


一 个 meta 标 签 中 的 charset 表 示 的 是 界面 的 字符 集 ， 考 虑 到 兼容 性 问题 ， 我 们 一 般 都 会 选择 utf-8 字 符 集 ; 第 二 个 meta 标 签 中 viewport 的 写法 含义 是 让 网 页 移动 设备 中 显示 不 支持 缩放 ， 否 则 界面 就 乱 了 。 


另外 ， 给 大 家 推荐 一 个 现成 的 制作 Web 版 应 用 界面 的 “利器 ”， 也 就 是 jQuery Mobile 开 发 组 件 。 jQuery 这 个 大 名 易 易 的 Javascript 开 发 工具 包 对 于 互联 网 开发 人 员 来 说 应 该 是 耳熟能详 了 ;在 移动 应 


大 行 其 道 的 今天 ，jQuery 团 队 又 给 我 们 奉献 了 jQuery Mobile 这 个 制作 Web 版 应 用 UI 界面 的 强大 工具 ， 下 面 我 们 来 了 解 一 下 其 主要 优点 。 


1 效果 绚丽 


对 于 Web 版 应 用 UI 来 说 ,jQuery Mobile 的 界面 算是 相当 出 彩 的， 特别 是 最 新 版 的 Query Mobile 中 ， 加 入 了 更 流畅 的 界面 渐变 ， 完 善 了 UI 组 件 的 细节 ， 让 用 户 体验 更 上 一 层 楼 。 大 家 可 以 访问 它 的 官 


网 http://jquerymobile.com 来 亲自 体验 一 下 。 


2. 组 件 丰 富 


从 官方 网 站 上 的 Demo 中 我 们 可 以 看 到 jQuery Mobile 提 供 了 几乎 所 有 移动 应 用 中 所 能 够 使 用 到 的 UI 组 件 。 另 外 ，jQuery 团 队 别出心裁 地 把 文档 与 Demo 结 合 起 来 ， 让 我 们 学 习 起 来 更 加 方便 、 高 效 。 


3 兼容 性 好 


兼容 性 是 我 们 使 用 Web 版 Web 界 面 的 主要 目的 之 一 ,jQuery Mobile 比较 好 地 兼容 了 Android、Apple iOS, Windows Phone 以 及 Blackberry 等 目前 比较 主流 的 移动 操作 系统 ， 甚 至 还 包括 各 种 操作 系 
统 中 不 同型 号 的 设备 ， 包 括 Phone 和 Pad 等 。 所 以 使 用 Query Mobile 可 以 在 很 大 程度 上 减轻 我 们 这 方面 的 压力 和 风险 。 


回 到 本 书 的 实例 中 ， 我 们 已 经 把 jQuery Mobile 1.0 版 本 整合 进来 了 ， 点 击 首页 (如 图 6-5 所 示 ) 中 的 jQuery Mobile 链 接 我 们 就 可 以 看 到 以 下 的 Web 版 的 Demo 界面 (如 图 6-6 所 示 ) ， 大 家 可 以 把 这 个 
Demo 当 做 实例 来 学 习 ， 也 可 以 作为 文档 来 参考 。 


© jQuery 


màabme Mamea 


A Touch-Optimized Web Framework for Smartphones & Tablets 


Welcome. Browse the jQuery Mobile components and learn haw 
to make rich, accessible, Epuch-friendly websites and apps. 


Overview 

Intro to jQuery Mobile 
Quick start quide 
Features 
Accessibility 
Supported platforms 


Pages & dialogs © 


图 6-6 jQuery Mobile 1.0% 


由 于 篇 幅 原因 ， 我 们 没有 办 法 详细 地 介绍 jQuery Mobile 的 用 法 ， 有 兴趣 的 读者 可 以 访问 官网 来 获取 更 多 的 信息 。 虽 然 Web 版 应 用 可 以 很 大 程度 上 减少 移动 应 用 Ul 界 面 开发 的 成 本 ， 但 是 HTML 毕 竟 不 
是 原生 的 ， 而 是 建立 在 浏览 器 之 上 的 ， 在 运行 效率 以 及 一 些 特殊 效果 方面 还 是 无 法 蔡 代 使 用 Android 应 用 框架 来 进行 UI 界面 开发 。 此 外 ， 本 书 实例 还 是 偏重 于 传统 的 移动 互联 网 应 用 开发 方式 ， 即 服务 端 来 
提供 API 接 口 ， 客 户 端 负责 UI 界面 的 方式 。 


6.8.2 ”Web 版 地 图 接口 


除了 Web 版 基础 UI 界面 之 外 ， 本 书 实例 还 给 大 家 准备 了 一 个 Web 版 地 图 接口 的 示例 ， 点 击 首页 (如 图 6-5 所 示 ) 中 
的 是 Google Map 服 务 提供 的 JavaScript 版 的 AP1， 当 然 这 里 只 是 使 有 


的 Map Demo 链 接 我 们 就 可 以 看 到 如 图 6-7 所 示 的 Web 版 地 图 页 面 。 该 地 图 示例 使 用 


有 了 最 基础 的 API 接 口 ， 关 于 Google Map API 的 详细 信息 可 参考 官方 网 站 ， 地 址 是 https://developers.google.com/maps/。 


127.0.0.1:8002/gomap.php 
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图 6-7 Web 版 地 图 页 面 


从 网 页 截图 中 我 们 可 以 看 到 ， 以 上 的 地 图 是 以 上 海 市 陆家嘴 地 区 为 中 心 来 展示 的 ， 缩 放 比例 的 等 级 大 约 在 中 间 位 置 


是 www/website/gomap.php， 如 代码 清单 6-55 所 示 。 


代码 清单 6-55 
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， 下 面 我 们 将 通过 代码 讲解 其 实现 原理 。 该 示例 所 对 应 的 php 脚 本 文件 


«html» 
<head> 
<meta http-equiv="content-type" content="text/html; charset=UTF-8"/> 
«meta name-"viewport" content-"user-scalable-no, width-device-width, initial-scale-1.0" /> 
<title>Simple V3 Map for Android</title> 
<script type-"text/javascript" src-"http://maps.google.com/maps/api/js?sensor-true"»«/script» 
<script type-"text/javascript"» 
var map; 
function initialize() ( 
var latitude - 0; 
var longitude = 0; 
// 获取 设备 经 纬度 
if (window.android) { 
latitude = window.android.getLatitude () 7 
longitude = window.android.getLongitude () ; 
// 设置 默认 经 纬度 (上 海陆 家 嘴 ) 
) else { 
latitude = 31.235087; 
longitude = 121.506656; 


l 
// Google Map 配 置 对 象 
Var myLatlng = new google.maps.LatLng (latitude, longitude) ; 
var myOptions = { 
zoom: 13, 
center: myLatlng, 
mapTypeld: google.maps .MapTypeId. ROADMAP 
) 
map = new google.maps .Map (document.getElementById ("map canvas"), myOptions) ; 


l 

// 供 Android 客 户 端 回 调 

function centerAt (latitude, longitude) { 
myLatlng = new google.maps.LatLng (latitude, longitude); 
map.panTo (myLat1ng) ; 

} 

</script> 

</head> 

<body onload-"initialize()"» 

<div id-"map canvas"»«/div» 
«/body» 
</html> 


地 图 示例 的 HTML 代 码 很 简单 ，body 部 分 只 有 一 个 id 为 map_canvas 的 div 层 ， 我 们 通过 body 标 签 中 的 onload 事 件 


(也 就 是 initialize 方 法 ) 来 控制 map_canvas 层 的 显示 。 在 initialize 方 法 中 ， 我 们 使 用 


window.android 对 象 来 获取 经 纬度 ， 如 果 获 取 不 到 则 会 使 用 上 海 市 陆家嘴 地 
google.maps.Map 对 象 将 地 图 展示 到 map_canvas 层 之 上 。 


区 的 经 纬度 来 蔡 代 。 然 后 将 获取 的 配置 信息 都 设置 到 Google Map 配 置 对 象 ， 即 myOptions 变 量 中 ， 最 后 创建 


另外 ， 代 码 中 的 centerAt 方 法 的 作用 是 设置 地 图 的 中 心 点 ， 是 用 来 给 Android 客 户 端 回调 的 。 当 此 界面 被 Android 应 用 的 内 庶 浏 览 器 加 载 时 ， 客 户 端 程序 可 以 通过 回调 该 方法 来 设置 地 图 的 中 心 点 ， 有 


关 用 法 请 参考 7.11.5 节 中 的 内 容 。 


69 J 


本 章 介 绍 了 使 


PHP 语 言 进行 服务 端 开发 的 入 门 知识 ， 让 大 家 对 基于 Hush Framework 服 务 端 框架 的 开发 、 调 试 以 及 文档 生成 方法 有 了 一 定 的 了 解 。 然 后 ， 按 照 微 博 应 


的 方法 。 


、 评 论 接 口 、 图 片 接 


、 微 博 接 [ 


验证 接口 、 用 户 接 [ 


以 及 通知 接 


， 这 些 接口 的 逻辑 几乎 涵盖 了 微 博 应 


PHP MVC 框 架 进行 服务 端 开 发 的 方方面面 。 


内 容 覆 盖 了 使 


本 章 内 容 包含 了 大 量 的 PHP 代 码 实例 ， 


的 。 当 然 如 果 大 家 有 兴趣 ， 也 可 以 尝试 使 用 其 他 的 PHP 框 架 甚 至 是 其 他 语言 来 实现 ， 原 则 上 只 需 


Ble ”客户 端 开发 


第 6 章 中 我 们 已 经 把 微 博 实例 应 


码 实现 ， 也 包含 了 使 用 Android 应 


开始 阅读 本 章 内 容 之 前 必须 


学 好 本 章 的 Android 客 户 端 开 发 的 内 容 。 所 以 ， 如 果 你 对 


框架 进行 移动 互联 网 


保证 接口 逻辑 和 JSON 返 


所 有 的 功能 。 最 后 ， 还 特别 介绍 了 使 


通过 学 习 和 理解 ， 我 们 会 发 现 使 
回 一 致 。 


的 服务 端 接 口 准备 好 了 ， 接 下 来 需要 介绍 的 就 是 微 博 实例 应 用 客户 端 开 发 部 分 的 内 容 了 。 本 章 是 本 书 的 最 为 核心 的 
开发 的 绝 大 部 分 重要 知识 ， 希 望 大 家 重视 本 章 。 


Web 方 式 来 实现 服务 端 接 


的 功能 模块 划分 ， 依 次 介绍 了 


基于 Hush Framework 的 微 博 服务 端 框 架 进 行 开发 还 是 非常 方便 


Bl 


由 于 本 章 的 内 容 比 较 多 ， 因 此 


阅读 之 前 我 们 先 要 梳理 一 下 各 章节 的 
在 7.2 节 中 介绍 了 客户 端 Ul 界 面 开 发 的 相关 内 容 ; 接着 从 7.3 节 到 7.5 节 介绍 


备 两 个 条 件 : 一 是 已 经 把 第 2 章 中 的 Android 开 发 基础 知识 全 部 掌握 ， 二 是 已 经 完全 理解 第 5 章 中 关于 
己 的 基础 还 没有 信心 ， 请 先 返回 对 应 的 章节 进行 复习 。 


屋 次 结构 。7.1 节 中 首先 介绍 了 Android 客 户 端 开发 的 基础 知识 ， 包 括 应 有 


内 容 之 一 ， 不 仅 详 细 介绍 了 微 博 实例 应 用 客户 端的 编 


客户 端 程 序 和 界面 架构 部 分 的 内 容 ; 否则 ， 我 们 一 定 没有 办 法 顺利 地 


配置 文件 的 介绍 ， 以 及 常规 程序 开发 与 调试 的 方法 ; 然后 


是 微 博客 户 端 程序 框架 中 公 


部 分 的 内 容 ， 比 如 网 络 通信 、 异 步 任务 以 及 全 局 功能 ; 


码 的 详细 解析 ， 这 里 我 们 不 仅 可 以 看 到 各 种 Android 组 件 以 及 UI 控件 的 实际 用 法 ， 还 可 以 学 到 更 多 高 级 的 界面 布局 技巧 以 及 代码 封装 经 验 。 


71 开发 入 门 


从 7.6 节 往 后 就 是 对 微 博客 户 端 主要 UI 界面 代 


在 开始 Android 客 户 端 编程 之 前 ， 我 们 还 需 


E 明 ， 接 下 来 我 们 就 


Hello World; 但 是 理论 还 需要 通过 实践 来 订 


个 Android 项 


711 开发 思路 梳理 


在 2. 


World 项 目 复杂 得 多 的 微 博 应 用 ， 到 | 底 应 该 怎样 入 手 呢 ? 接 下 来 我 们 来 梳理 一 下 


0.2 节 中 ， 我 们 已 经 创建 了 自己 的 首 个 Android 项 目 Hello World， 并 且 在 模拟 器 上 成 功 编译 并 执行 了 ， 对 了 


了 解 一 些 实际 开发 中 需要 的 准备 事项 。 其 实 通过 对 本 书 第 2 章 内 容 的 学 习 ， 我 们 已 经 
始 通过 微 博 实例 应 用 的 编程 实现 过 程 来 实践 Android 应 


发 的 思路 。 


Android 应 


发 的 基础 理论 知识 ， 并 且 也 


备 了 Android 编 程 : 


学 习 创建 了 自己 第 一 


开发 之 道 。 


开发 的 基本 流程 已 经 有 了 一 定 的 了 解 ， 但 是 现在 我 们 


框架 。 首 先是 模型 层 (Model) ， 由 于 与 实际 项 目的 


面 对 的 是 比 Hello 


功能 模块 结合 得 比较 


众所周知 ， 微 博 应 用 必然 是 建立 在 Android 应 用 框架 之 上 的 ; 因此， 我 们 可 以 先 按照 MVC 的 设计 思路 来 构造 一 下 Android 应 
紧密 ，Android 应 用 框架 中 不 会 提供 任何 针对 模型 层 的 支持 ， 因 此 这 部 分 功能 需要 我 们 自己 实现 ;而 视图 层 (View) 则 是 Android 应 用 框架 重点 支持 的 功能 ， 这 部 分 内 容 我 们 就 不 需要 自己 实现 了 ， 只 需要 
按照 Android 应 用 框架 的 套路 来 执行 即 可 ; 至 于 控制 器 层 (Controller) ， 虽然 Android 应 用 框架 已 经 为 我 们 准备 了 丰富 的 组 件 ， 但 是 我 们 还 是 需要 进行 必要 的 封装 ， 让 日 后 的 开发 工作 更 加 轻松 。 其实, 之 
前 的 5.2 节 中 已 经 介绍 过 本 书 微 博 实例 将 会 使 用 到 的 基础 框架 ， 后 面 我 们 将 通过 微 博 实例 的 各 个 功能 的 实现 来 逐步 介绍 该 基础 框架 的 使 用 。 

通过 前 面 对 微 博 应 用 开发 思路 的 分 析 ， 并 参考 Hello World 项 目的 开发 思路 ， 我 们 可 以 大 致 定义 出 开发 微 博 应 用 客户 端 所 需要 进行 的 几 个 步骤 ， 细 节 如 下 。 

1. 创 建 初始 项 

按照 与 Hello World 项 目 相同 的 步 又， 创建 微 博 应 用 的 Android 基 础 项 目 代码 ， 定 义 项 目 名 (app-demos-client) 、 应 用 名 (demos) UREZ (com.app.demos) ， 并 指定 一 个 入 口 活动 控制 器 
(Activity) 。 

2. 创 建 基础 类 库 

的 src/ 源 代码 目录 下 依次 建立 起 对 应 的 包 目录 ， 如 com.app.demos.base (核心 基础 类 包 ) 、com.app.demos.util (核心 工具 类 包 ) 并 实现 其 


按照 5.2 节 中 我 们 对 程序 基础 框架 结构 的 设计 ， 在 项 
中 最 核心 的 基础 类 ， 比 如 界面 控制 器 基 类 (BaseUi) 、 模 型 


3. 实 现 应 用 逻辑 


基于 基础 类 库 实现 


4 修改 应 用 配置 


把 界面 控制 器 、 服 务 组 件 等 都 添加 到 应 


但 是 ， 微 博 应 
码 的 来 龙 去 脉 讲 清楚 。 
才 会 比较 好 。 


类 (BaseModel) 以 及 列表 组 件 基 类 (BaseList) 等 。 


体 的 功能 逻辑 、Activity 界 面 控制 器 、Service 服 务 组 件 以 及 测试 用 例 等 。 同 时 还 需要 根 寺 


实例 项 目的 讲解 方式 与 之 前 的 Hello World 项 目 不 同 。 因 为 本 实例 的 代码 比较 复杂 ， 在 没有 太 多 
因此 ， 本 书 推荐 读者 通过 阅读 源 代 码 的 方式 ， 


居 原 型 设计 来 实现 应 用 的 UI 界面 ， 把 微 博 应 


的 逻辑 前 后 串联 起 来 。 


配置 文件 (Android-Manifest.xml) 中 去 ， 然 后 发 布 到 模拟 器 上 进行 测试 和 优化 。 


=a 


外 ， 本 书 附带 的 资源 中 已 经 包含 了 微 博 实例 客户 端的 完整 源 代码 ， 大 家 只 需要 通过 Eclipse 工 : 


的 内 容 。 成 功 导 入 后 ， 我 们 会 在 Eclipse 的 项 目 浏 览 界面 


HISA (Import) 选项 来 把 整个 项 目 导 入 到 
中 发 现 微 博 客户 端 (app-demos-client) 和 微 博 服务 端 (app-demos-server) 两 个 项 目 ，Eclipse 的 界面 截图 如 图 7-1 所 示 。 


发 经 验 的 情况 下 ， 如 果 采 / 


之 前 的 讲解 方式 ， 按 照 代 码 实现 的 步骤 来 讲 ， 很 难 把 实例 代 
结合 本 章 的 内 容 ， 逐 步 学 习 和 掌握 Android 客 户 端 开发 的 内 容 。 在 对 客户 端 实例 源 代码 理解 透彻 的 基础 之 上 再 动手 实践 ， 这 样 学 习 效果 


发 环境 中 即 可 使 用 ， 源 码 安装 的 


体 方法 可 参考 附录 B 中 


E app-demos-client 


mi, Android 2.7 
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图 7-1 微 博 实例 项 目 代码 


如 果 你 准备 动手 来 逐步 实现 微 博 应 用 的 客户 端 部 分 ， 可 以 参考 图 7-1 中 所 示 的 app-demos-client 项 目的 类 包 结 构 来 实施 ， 这 些 类 包 的 定义 和 作用 我 们 在 5.2 节 中 已 经 设计 好 了 ， 具 体 说 明 请 参考 表 5-2。 
在 本 章 后 面 的 内 容 中 ， 我 们 会 把 微 博 应 用 客户 端的 各 个 功能 模块 和 Ul 界 面 的 相关 内 容 分 解 开 来 ， 逐 个 进行 介绍 ， 我 们 可 以 把 每 个 部 分 当做 独立 的 实例 来 学 习 ， 这 些 内 容 履 盖 Android 应 用 开发 中 的 方 方 面 
面 。 在 理想 状态 下 ， 通 过 本 章 内 容 的 学 习 ， 我 们 可 以 逐步 熟悉 Android 应 用 开发 ， 进 而 形成 自己 成 熟 的 开发 思路 。 


Ej 


7.4.2 ”掌握 应 用 配置 文件 


想 要 使 用 Android 应 用 框架 来 进行 开发 ， 首 先 必须 掌握 Android 应 用 配置 文件 (Android-Manifest.xml) 的 用 法 。 每 个 Android 应 用 都 必须 有 一 个 应 用 配置 文件 ， 该 文件 主要 包含 了 Android 应 用 中 必 不 
可 少 的 配置 信息 ， 比 如 应 用 的 基础 配置 、 权 限 配置 以 及 组 件 配置 (包括 Android 四 大 组 件 ) 等 。 代 码 清单 7-1 中 就 是 一 个 标准 AndroidManifest 文 件 的 样 例 ， 接 下 来 我 们 将 以 其 为 参照 ， 认 识 一 下 应 用 配置 文 
件 的 用 法 。 


代码 清单 7-1 


<?xml version="1.0" encoding-"utf-8"?» 
<manifest> 
<!-- 基本 配置 --> 
<uses-permission /> 
<permission /> 
<permission-tree /> 
<permission-group /> 
<instrumentation /> 
«uses-sdk /> 
<uses-configuration /> 
<uses-feature /> 
<supports-screens /> 
<compatible-screens /> 
<supports-gl-texture /> 
<!-- 应 用 配置 --> 
<application> 
<!-- Activity RE -> 
<activity> 
<intent-filter> 
<action /> 
<category /> 
<data /> 
</intent-filter> 
<meta-data /> 
</activity> 
<activity-alias> 
<intent-filter> . . . «/intent-filter» 
«meta-data /> 
</activity-alias> 


<!-- Service 配置 --> 

<service> 
<intent-filter> . . . </intent-filter> 
«meta-data/» 

</service> 

<!-- Receiver 配置 --» 

<receiver> 
<intent-filter> . . . «/intent-filter» 
«meta-data /> 

</receiver> 

<!-- Provider 配置 --> 

<provider> 


<grant-uri-permission /> 
<meta-data /> 
</provider> 
<!-- 所 需 类 库 配 置 --> 
<uses-library /> 
</application> 
</manifest> 


从 配置 清单 7-1 中 的 示例 代码 中 ， 我 们 可 以 看 出 Android 配 置 文件 采用 XML 作为 描述 语言 ， 每 个 XML 标签 都 有 不 同 的 含义 ， 大 部 分 的 配置 参数 都 放 在 标签 的 属性 中 。 下 面 我 们 便 按 照 以 上 配置 文件 样 例 中 


的 先后 顺序 来 学 习 Android 配 置 文件 中 主要 元 素 与 标签 的 


法 。 


1.<manifest/> 标 签 


<manifest/> 标 签 是 AndroidManifest.xm| 配 置 文件 的 根 元 素 ， 必 须 包 含 一 个 <application/> 元 素 并 且 指 定 xImns: android 和 package 属 性 。xlImns: android 指 定 了 Android 的 命名 空间 ， 默 认 情况 
下 是 “http://schemas.android.com/apk/res/android”; 而 package 是 标准 的 应 用 包 名 ， 也 是 一 个 应 用 进程 的 默认 名 称 ， 以 本 书 微 博 应 用 实例 中 的 包 名 为 例 ， 即 “com.app.demos” 就 是 一 个 标准 的 
Java 应 用 包 名 ， 我 们 为 了 避免 命名 空间 的 冲突 ， 一 般 会 以 应 用 的 域名 来 作为 包 名 。 当 然 还 有 一 些 其 他 常用 的 属性 需要 注意 一 下 ， 比 如 android: versionCode 是 给 设备 程序 识别 版 本 用 的 ， 必 须 是 一 个 整数 值 
代表 app 更 新 过 多 少 次 ; Mandroid: versionName 则 是 给 用 户 查看 版 本 用 的 ， 需 要 具备 一 定 的 可 读 性 ， 比 如 “1.0.0” 这 样 的 。< manifest/> 标 签 的 语法 范例 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="string" 
android:sharedUserId="string" 
android:sharedUserLabel="string resource" 
android:versionCode="integer" 
android:versionName="string" 


android:installLocation-["auto" | "internalOnly" | "preferExternal"] > 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</manifest> 


2.<uses-permission/> 标 签 


为 了 保证 Android 应 用 的 安全 性 ， 应 用 框架 制定 了 比较 严格 的 权限 系统 ， 一 个 应 用 必须 声明 了 正确 的 权限 才 可 以 使 用 相应 的 功能 。 例 如 ， 我 们 需要 让 应 用 能 够 访问 网 络 ， 就 需要 为 应 用 配 
& “android.permission.INTERNET” 权限， 而 如 果 要 使 用 设备 的 相机 功能 ， 则 需要 设置 “android.permission.CAMERA” 权限 等 。<uses-permission/> 就 是 我 们 最 经 常 使 用 的 权限 设 定 标签 ， 我 们 通过 
设 定 android: name 属 性 来 声明 相应 的 权限 名 ， 比 如 在 微 博 应 用 实例 中 ， 我 们 就 是 根据 应 用 的 所 需 功 能 声明 了 对 应 的 权限 ， 相 关 代 码 如 代码 清单 7-3 所 示 。 


代码 清单 7-3 


«manifest http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 

<!-- 网 络 相关 功能 --> 

<uses-permission android:name-"android.permission.INTERNET" /> 

<uses-permission android:name="android.permission.ACCESS NETWORK STATE" /> 

<uses-permission android:name="android.permission.ACCESS COARSE LOCATION" /> 

<uses-permission android:name="android.permission.ACCESS FINE LOCATION" /> 

<!-- 读 取 电话 状态 --> u 7 

«uses-permission android:name-"android.permission.READ PHONE STATE" /> 

<!-- 通知 相关 功能 --> 

<uses-permission android:name="android.permission.VIBRATE" /> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</manifest> 


3.<permission/> 标 签 


这 是 权限 声明 标签 ， 定 义 了 应 用 需要 的 具体 权限 。 通 常情 况 下 我 们 不 需要 为 自己 的 应 用 程序 声明 某 个 权限 ， 除 非 需要 给 其 他 应 用 程序 提供 可 调用 的 代码 或 者 数据 ， 这 个 时 候 你 才 需 要 使 
<permission/> 标 签 。 该 标签 中 提供 了 android: name (权限 名 标签 ) 、android: icon (权限 图 标 ) 以 及 android: description (权限 描述 ) 等 属性 ， 另 外 还 可 以 和 <permission-group/> 以 及 
<permission-tree/> 配 合 使 用 来 构造 更 有 层次 的 、 更 有 针对 性 的 权限 系统 。< permission/> 标 签 语法 范例 如 代码 清单 7-4 所 示 。 


代码 清单 7-4 


<permission android:description="string resource" 
android:icon="drawable resource" 
android:label="string resource" 
android:name="string" 
android:permissionGroup="string" 
android:protectionLevel=["normal" | "dangerous" "signature" | "signatureOrSystem"] /> 


4.«instrumentation/» tx 


此 标签 用 于 声明 Instrumentation 测 试 类 来 监控 Android 应 用 的 行为 并 应 用 到 相关 的 功能 测试 中 ， 其 中 比较 重要 的 属性 有 : android: functionalTest (测试 功能 开关 ) android: 
handleProfiling (profiling 调 试 功能 开关 ) 、android: targetPackage (测试 用 例 目标 对 象 ) 等 。 另 外 ， 我 们 需要 注意 的 是 Instrumentation 对 象 是 在 应 用 程序 的 组 件 之 前 被 实例 化 的 ， 这 点 在 组 织 测试 逻 
辑 的 时 候 需 要 被 考虑 到 。<instrumentation/> 标 签 语法 范例 如 代码 清单 7-5 所 示 。 


代码 清单 7-5 


<instrumentation android:functionalTest=["true" | "false"] 
android:handleProfiling=["true" | "false"] 
android:icon="drawable resource" 
android:label="string resource" 
android:name="string" 
android:targetPackage="string" /> 


5.<uses-sdk/> 标 签 


此 标签 用 于 指定 Android 应 用 中 所 需要 使 用 的 SDK 的 版 本 ， 比 如 我 们 的 应 用 必须 运行 于 Android 2.0 以 上 版 本 的 系统 SDK 之 上 ， 那 么 就 需要 指定 应 用 支持 最 小 的 SDK 版 本 数 为 5， 当 然 ， 每 个 SDK 版 本 都 会 
有 指定 的 整数 值 与 之 对 应 ， 比 如 我 们 最 常用 的 Android 2.2.x 的 版 本 数 是 8。 而 且 ， 除 了 可 以 指定 最 低 版 本 之 外 ，< uses-sdk/> 标 签 还 可 以 指定 最 高 版 本 和 目标 版 本 ， 语 法 范例 如 代码 清单 7-6 所 示 。 


代码 清单 7-6 


<uses-sdk android:minSdkVersion="integer" 
android:targetSdkVersion="integer" 
android:maxSdkVersion="integer" /> 


6.<uses-configuration/> 与 <uses-feature/> 标 签 


这 两 个 标签 都 是 用 于 描述 应 用 所 需要 的 硬件 和 软件 特性 ， 以 便 防止 应 用 在 没有 这 些 特性 的 设备 上 安装 。 <uses-configuration/> 标 签 中 ， 比 如 有 些 设备 带 有 D-pad 或 者 Trackball 这 些 特殊 硬件 ， 那 么 


android: reqFiveWayNav 属 性 就 需要 设置 为 true; 如 果 有 一 些 设备 带 有 硬件 键盘 ，android: reqHardKeyboard 也 需要 被 设置 为 true。 另 外 ， 如 果 设备 需要 支持 蓝牙 ， 我 们 可 以 使 用 <uses-feature 
android: name="android.hardware.bluetooth"/> 来 支持 这 个 功能 。 这 两 个 标签 主要 用 于 支持 一 些 特殊 的 设备 中 的 应 用 ， 它 们 的 语法 范例 见 代码 清单 7-7。 


代码 清单 7-7 


<uses-configuration android:reqFiveWayNav=["true" | "false"] 
android:reqHardKeyboard=["true" | "false"] 
android:reqKeyboardTyp: undefined" | "nokeys" | "qwerty" | "twelvekey"] 


android:reqNavigation=["undefined" | "nonav" | "dpad" | "trackball" | "wheel"] 

android:reqTouchScreen=["undefined" | "notouch" | "stylus" | "finger"] /> 
<uses-feature android:name="string" 

android:required=["true" | "false"] 


android:glEsVersion="integer" /> 


7.<uses-library/> 标 签 


此 标签 通常 用 于 指定 Android 应 用 使 用 的 外 部 用 户 库 ， 除 了 系统 自 带 的 android.app、android.content、android.view 和 android.widget 这 些 默认 类 库 之 外 ， 有 些 应 用 可 能 还 需要 一 些 其 他 的 Java 类 库 
作为 支持 ， 这 种 情况 下 我 们 就 可 以 使 用 <uses-library/ > 标签 让 ClassLoader 加 载 其 类 库 供 Android 应 用 运行 时 用 。< uses-library/> 标 签 的 用 法 很 简单 ， 使 用 范例 如 代码 清单 7-8 所 示 。 


代码 清单 7-8 


<uses-library android:name="string" 
android:required=["true" | "false"] /> 


小 贴 士 : 当 运行 Java 程 序 时 ， 首 先 运行 JVM (Java 虚 拟 机 ) ， 然 后 再 把 Java 类 加 载 到 JVM 里 运行 ， 负 责 加 载 Java 类 的 这 部 分 就 叫 作 ClassLoader。 当 然 ，ClassLoader 是 由 多 个 部 分 构成 的 ， 每 个 部 分 都 负责 相应 
的 加 载 工 作 。 当 运行 一 个 程序 的 时 候 ，JVM 启 动 ， 运 行 BootstrapClassLoadet， 该 ClassLoader 加 载 Java 核 心 API (ExtClassLoader 和 AppClassLoadet 也 在 此 时 被 加 载 ) ， 然 后 调用 EExtClassLoader 加 载 扩展 API， 最 后 
AppClassLoader 加 载 CLASSPATH 目 录 下 定义 的 Class， 这 就 是 一 个 Java 程 序 最 基本 的 加 载 流程 。 


8.<supports-screens/> 标 签 


对 于 一 些 应 用 或 者 游戏 来 说 ， 只 能 支持 某 些 屏 幕 大 小 的 设备 或 者 在 某 些 设备 中 的 效果 比较 好 ， 这 时 我 们 就 会 使 用 <supports-screens/> 标 签 来 指定 支持 的 屏幕 特征 。 其 中 比较 重要 的 属性 包括 : 
android: resizeable (屏幕 自 适 应 属性 ) 、android: smallScreens (小 屏 支 持 属性 ) 、android: normalScreens (中 屏 支 持 属性 ) . android: largeScreens (大 屏 支持 属性 ) 和 android: 
xlargeScreens (特大 屏 支 持 属性 ) , android: anyDensity ( 按 屏幕 泻 染 图 像 属性 ) ， 以 及 android: requiresSmallestWidthDp (最 小 屏幕 宽度 属性 ) 等 。<supports-screens/> 标 签 的 语法 范例 如 代码 
清单 7-9 所 示 。 


代码 清单 7-9 


<supports-screens android:resizeable=["true"| "false"] 
android:smallScreens=["true" | "false"] 
android:normalScreens=["true" | "false"] 
android:largeScreens=["true" | "false"] 
android:xlargeScreens=["true" | "false"] 
android:anyDensity=["true" | "false"] 


android: requiresSmallestWidthDp="integer" 
android: compatibleWidthLimitDp="integer" 
android: largestWidthLimitDp="integer"/> 


9.<application/ > 标签 


此 标签 是 应 用 配置 的 根 元 素 ， 位 于 <manifest/> 下层， 包含 所 有 与 应 用 有 关 配 置 的 元 素 ， 其 属性 可 以 作为 子 元 素 的 默认 属性 ， 常 用 的 属性 包括 : android: label (应 用 名 ) 、android: icon (SAE 
标 ) . android: theme (应 用 主题 ) 等 。 当 然 ，<application/> 标 签 还 提供 了 其 他 丰富 的 配置 属性 ， 由 于 篇 幅 原因 就 不 列举 了 ， 大 家 可 以 打开 Android SDK 文 档 来 进一步 学 习 ， 语 法 范例 见 代码 清单 7- 
10。 


代码 清单 7-10 


«application android:allowTaskReparenting=["true" | "false"] 
android:backupAgent-"string" 
android:debuggable-["true" | "false"] 
android:description-"string resource" 
android:enabled-["true" | "false"] 
android:hasCode-["true" | "false"] 
android:hardwareAccelerated-["true" | "false"] 
android:icon-"drawable resource" 
android:killAfterRestore-["true" | "false"] 
android:label-"string resource" 
android:logo-"drawable resource" 
android:manageSpaceActivity-"string" 
android:name-"string" 
android:permission-"string" 


android:persistent-["true" | "false"] 
android:process-"string" 
android:restoreAnyVersion-["true" | "false"] 


android:taskAffinity-"string" 

android:theme-"resource or theme" » 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
«/application» 


10. «activity/ > 标签 


此 标签 是 Activity 活 动 组 件 〈 即 界面 控制 器 组 件 ) 的 声明 标签 ， Android 应 用 中 的 每 一 个 Activity 都 必须 在 AndroidManifest.xml| 配 置 文 件 中 声明 ， 否 则 系统 将 不 识别 也 不 执行 该 Activity。<activity/> 标 
签 中 常用 的 属性 有 : android: name (Activity 对 应 类 名 ) 、android: theme (对 应 主题 ) 、android: launchMode (加 载 模式 ) (02.3.45) 、android: windowSoftlnputMode (键盘 交互 模 
式 ) 等 ， 其 他 的 属性 用 法 大 家 可 以 参考 Android SDK 文 档 学 习 。 另 外 ，<activity/> 标 签 可 以 包含 用 于 消息 过 滤 的 <intent-filter/> 元 素 ， 当 然 还 可 以 包含 用 于 存储 预定 义 数据 的 <meta-data/> 元 素 。 
<activity/> 标 签 的 语法 范例 见 代 码 清单 7-11。 


代码 清单 7-11 


<activity android:allowTaskReparenting=["true" | "false"] 
android:alwaysRetainTaskState=["true" | "false"] 
android:clearTaskOnLaunch=["true" | "false"] 
android:configChanges=["mcc", "mnc", "locale", 
"touchscreen", "keyboard", "keyboardHidden", 
"navigation", "orientation", "screenLayout", 
"fontScale", "uiMode"] 
android:enabled-["true" | "false"] 
android:excludeFromRecents-["true" | "false"] 
android:exported-["true" | "false" 
android:finishOnTaskLaunch-["true" | "false"] 
android:hardwareAccelerated-["true" | "false"] 
android:icon-"drawable resource" 
android:label-"string resource" 
android:launchMode-["multiple" | "singleTop" | "singleTask" | "singleInstance"] 
android:multiprocess-["true" | "false"] 
android:name-"string" 
android:noHistory-["true" | "false"] 


android:permission-"string" 
android:process-"string" 
android:screenOrientation-["unspecified" | "user" | "behind" | 


"landscape" | "portrait" | 

"sensor" | "nosensor" 
android:stateNotNeeded=["true" | "false"] 
android:taskAffinity="string" 
android:theme="resource or theme" 
android:windowSoftInputMode=["stateUnspecified", 

"stateUnchanged", "stateHidden", 

"stateAlwaysHidden", "stateVisible", 

"stateAlwaysVisible", "adjustUnspecified", 


"adjustResize", "adjustPan"] > 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</activity> 


ET 


"m 


11.<activity-alias/> 标 签 


他 比较 


此 标签 是 Activity 组 件 别名 的 声明 标签 ， 简 单 来 说 就 是 Activity 的 快捷 方式 ， 属 性 android: targetActivity 表 示 的 就 是 其 相关 的 Activity 名 ， 当 然 必须 是 前 面 已 经 声明 过 的 Activity。 除 此 之 外 ， 


见 的 属性 有 : android: name (Activity 别 名 名 称 ) 、android: enabled (别名 开关 ) 、android: permission (权限 控制 ) 等 。 另 外 ， 我 们 还 需要 注意 的 是 ，Activity 别 名 也 是 一 个 独立 的 Activity， 可 
以 拥有 自己 的 <intent-filter/> 和 <meta-data/> 元 素 ， 其 语法 范例 如 代码 清单 7-12 所 示 。 


代码 清单 7-12 


<activity-alias android:enabled=["true" | "false"] 

android:exported=["true" | "false"] 

android:icon="drawable resource" 

android:label="string resource" 

android:name="string" 

android:permission="string" 

android:targetActivity="string" > 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</activity-alias> 


12.<intent-filter/> 与 <action/>、<category/>、<data/> 标 签 


<intent-filter/> 标 签 常 用 于 Intent 消 息 过 滤器 的 声明 。 在 前 面 的 2.3.2 节 中 ， 我 们 已 经 对 Android 应 用 框架 中 的 Intent 消 息 做 了 比较 详细 的 介绍 ， 了 解 到 Intent 消 息 对 于 Android 应 用 系统 来 说 是 非常 重 


要 的 “ 粘 合 剂 ”。 <intent-filter/> 元 素 可 以 放 在 <activity/>、<activity-alias/>、<service/> 和 <receiver/> 元 素 标签 中 ， 来 区 分 可 用 于 处 理 消息 的 Activity 控 制 器 、Service 服 务 和 广播 接收 器 (Broadcast 
Receiver) 。 另 外 ， 我 们 知道 Intent 消 息 还 包含 名 称 、 动 作 、 数 据 、 类 别 等 几 个 重要 属性 。 这 点 与 该 标签 的 写法 也 有 一 定 的 关系 ， 比 如 <intent-filter/> 中 必须 包含 <action/> 元 素 ， 即 用 于 描述 具体 消息 的 
名 称 ; <category/> 标 签 则 用 于 表示 能 处 理 消息 组 件 的 类 别 ， 即 该 Action 所 符合 的 类 别 ; 而 <data/> 元 素 则 用 于 描述 消息 需要 处 理 的 数据 格式 ， 我 们 甚至 还 可 以 使 用 正则 表达 式 来 限定 数据 来 源 。 当 然 ， 这 
些 元 素 和 标签 的 具体 用 法 我 们 还 需要 慢 慢 学 习 ， 代 码 清单 7-13 是 标准 <intent-filter/> 元 素 标签 的 语法 范例 。 


代码 清单 7-13 


<intent-filter android:icon="drawable resource" 
android:label="string resource" 
android:priority="integer" > 
<action android:name="string" /> 
<category android:name="string" /> 
<data android:host="string" 
android:mimeType="string" 
android:path="string" 
android:pathPattern="string" 
android:pathPrefix="string" 
android:port="string" 
android:scheme="string" /> 
</intent-filter> 


13.<meta-data/> 标 签 


此 标签 用 于 存储 预定 义 数据 ， 和 <intent-filter/> 类 似 ，<meta-data/> 也 可 以 放 在 <activity/>、<activity-alias/>、<service/> 和 <receiver/> 这 四 个 元 素 标签 中 。Meta 数 据 一 般 会 以 键 值 对 的 形式 出 


现 ， 个 数 没有 限制 ， 而 这 些 数 据 都 将 被 放 到 一 个 Bundle 对 象 中 ， 在 程序 中 ， 我 们 就 可 以 使 用 ActivityInfo、Servicelnfo 甚 至 Applicationlnfo 对 象 的 metaData 属 性 进行 读 取 。 假 设 我 们 在 一 个 Activity 中 定义 
了 一 个 <meta-data/> 元 素 ， 定 义 语法 如 代码 清单 7-14 所 示 。 


代码 清单 7-14 


<activityhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
<meta-data android:name="testData" android:value="Test Meta Data"></meta-data> 
</activity> 


在 程序 代码 中 ， 我 们 可 以 使 用 代码 清单 7-15 中 的 代码 来 获取 Meta 数 据 的 值 。 由 于 之 前 的 Meta 数 据 是 定义 在 Activity 元 素 中 ， 所 以 这 里 我 们 使 用 getActivitylnfo 方 法 来 获取 Activitylnfo 对 象 。 类 似 的 ， 


我 们 还 可 以 使 用 getServicelnfo 或 者 getApplicationlnfo 方 法 来 获得 相应 组 件 对 象 中 的 数据 。 


E 


代码 清单 7-15 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
ActivityInfo info = this.getPackageManager () e 
.getActivityInfo (getComponentName(), PackageManager.GET META DATA); 
String testData = info.metaData.getString ("testData"); il 
System.out.println("testData:" + testData); 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


14.<service/> 标 签 


此 标签 是 服务 组 件 (Service) 的 声明 标签 ， 用 于 定义 与 描述 一 个 具体 的 Android 服 务 ， 主 要 属性 有 : android: name (Service 服 务 类 名 ) . android: icon (服务 图 标 ) . android: label (服务 描 
以 及 android: enabled (服务 开关 ) 等 。 关 于 Service 服 务 组 件 的 概念 和 用 法 请 参考 2.4.2 节 的 内 容 ， 代 码 清单 7-16 是 <service> 标 签 的 语法 范例 。 


代码 清单 7-16 


<service android:enabled=["true" | "false"] 

android:exported=["true" | "false"] 

android:icon="drawable resource" 

android:label="string resource" 

android:name="string" 

android:permission="string" 

android:process="string" > 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</service> 


15.<receiver/ > 标签 


此 标签 是 广播 接收 器 组 件 (Broadcast Receiver) 的 声明 标签 ， 用 于 定义 与 描述 一 个 具体 的 Android 广 播 接收 器 ， 其 主要 属性 和 <service> 标 签 有 些 类 似 ， 主 要 包括 : android: name (Broadcast 
Receiver 接 收 器 类 名 ) 、android: icon (接收 器 图 标 ) . android: label (接收 器 描述 ) 以 及 android: enabled (接收 器 开关 ) 等 。 关 于 Broadcast Receiver 广 播 接收 器 组 件 的 概念 和 用 法 请 参考 2.4.3 节 
的 内 容 ，<receiver> 标 签 的 语法 范例 见 代 码 清单 7-17。 


代码 清单 7-17 


«receiver android:enabled-["true" | "false"] 
android: exported-["true" l "false" Bul 
icon-"drawable resource" 
:label="string resource" 
android:name-"string" 
ermission-"string" 
:process="string" > 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</receiver> 


16.«provider/» 5 «grant-uri-permission/» tr 


<provider/ > 标签 是 另 一 个 “四 大 组 件 ”， 内 容 提供 者 组 件 (Content ey. 的 声明 标签 。 关 于 内 容 提供 者 组 件 的 概念 和 用 法 请 参考 2.4.4 节 的 内 容 ， 不 再 歼 述 。< provider/> 标 签 除了 和 其 他 组 件 
相同 的 android: name、android: icon 和 android: label 等 基础 属性 之 外 ， 还 提供 了 用 于 支持 其 功能 的 特殊 属性 ， 如 : 内 容 提供 者 标识 名 称 android: authorities， 对 指定 URI 授 予 权限 标识 android: 
grantUriPermission 以 及 具体 的 读 、 写 权限 ， 即 android: readPermission 和 android: writePermission 等 。 当 然 ， 这 些 属性 的 具体 用 法 我 们 还 需要 慢 慢 学 习 ，< provider/> 标 签 的 语法 范例 见 代码 清单 7- 
18, 


代码 清单 7-18 


<provider android:authorities="list" 

android: enabled=["true" | "false"] 
xported-["true" | "false"] 
rantUriPermissions-["true" | "false"] 
con-"drawable resource" 
:initOrder-"integer" 

:label="string resource" 
:multiprocess-["true" | "false"] 
android:name-"string" 

ermission-"string" 

rocess-"string" 

eadPermission 
yncable-["true" | "false"] 

:writePermission="string" > 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</provider> 


认识 AndroidManifest.xml 应 用 配置 文件 的 基础 用 法 之 后 ， 我 们 来 解读 一 下 本 书 微 博 应 用 客户 端 项 目的 配置 文件 ， 相 关 XML 代 码 如 代码 清单 7-19 所 示 。 


代码 清单 7-19 


<?xml version="1.0" encoding="ut£-8"?> 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.app.demos" android:versionCode-"1" android:versionName-"1.0"» 
«application android:name-".base.BaseApp" 

android:icon-"Gdrawable/icon" android:label-"Gstring/app name" 

<!-- Activity defines --> 

«activity android:name=".ui.UiLogin" 
android: theme="@style/com.app.demos.theme.login"> 
<intent-filter> 

<action android:name="android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 

</activity> 

<activity android:name=".ui.UiIndex" 
android: theme="@style/com.app.demos. theme. light"> 
<intent-filter> 

<action android:name="android.intent.action.VIEW" /> 
«category android:name="android. intent .category. DEFAULT" /> 
</intent-filter> 

</activity> 

<activity android:name-".ui.UiBlog" 
android: theme="@style/com.app.demos.theme.light"> 
<intent-filter> 

<action android:name="android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 

«/activity» 

«activity android:name=".ui.UiBlogs" 
android: theme="@style/com.app.demos. theme. light"> 
<intent-filter> 

<action android:name="android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 

«/activity» 

«activity android:name=".ui.UiConfig" 
android: theme="@style/com.app.demos. theme. light"> 
<intent-filter> 

<action android:name="android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 

«/activity» 

«activity android:name-".ui.UiEditText" 
android:theme-"(style/com.app.demos.theme.light" 
android:windowSoftInputMode-"stateVisible|adjustResize" 
android: launchMode="singleTop"> 
<intent-filter> 

«action android:name-"com.app.demos.EDITTEXT" /> 

«action android:name-"android.intent.action.VIEW" /> 

«category android:name-"android.intent.category.DEFAULT" /» 
«/intent-filter» 

«/activity» 

«activity android:name-" .ui.UiEditBlog" 
android:theme-"(style/com.app.demos.theme.light" 
android:windowSoftInputMode-"stateVisible|adjustResize" 
android: launchMode="singleTop"> 
<intent-filter> 

<action android:name="com.app.demos.EDITBLOG" /> 

<action android:name="android.intent.action.VIEW" /> 

«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 

</activity> 

<activity android:name=".ui.UiSetFace" 
android: theme="@style/com.app.demos.theme. light" 
android: launchMode="singleTop"> 
<intent-filter> 

<action android:name="android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 

</activity> 

<activity android:name=".demo.DemoWeb" 
android: theme="@style/com.app.demos.theme.light"> 
<intent-filter> 

<action android:name="android.intent.action.VIEW" /> 


</mani 


<category android:name-"android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 
<activity android:name=".demo.DemoMap" 
android: theme="@style/com.app.demos. theme. light"> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name-"android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 
<activity android:name=".test.TestUi" 
android: theme="@style/com.app.demos. theme. light"> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name-"android.intent.category.DEFAULT" /> 
</intent-filter> 


</activity> 

<!-- Service defines --> 

<service android:name-".service.NoticeService" android:label-"Notification Service"/» 
</application> 
<!-- For using network --> 


<uses-permission android:name-"android.permission.INTERNET" /> 
<uses-permission android:name-"android.permission.READ PHONE STATE"/» 
<uses-permission android:name-"android.permission.ACCESS NETWORK STATE" /> 
<uses-permission android:name-"android.permission.ACCESS COARSE LOCATION" /> 
<uses-permission android:name-"android.permission.ACCESS FINE LOCATION" /> 
<!-- For using notification --» T = 
<uses-permission android:name-"android.permission.VIBRATE" /> 

fest> 


从 上 述 配置 文件 中 ， 我 们 可 以 清晰 地 看 到 微 博 实例 应 用 的 名 称 、 包 名 、 所 需 权 限 、Service 服 务 以 及 所 有 的 Activity 界 面 控制 器 (如 表 7-1 所 示 ) ， 其 中 特别 需要 注意 的 就 是 整个 应 用 入 口 界面 ， 也 就 是 
<action/> 标 签 值 为 android.intent.action.MAIN 的 Activity， 即 UiLogin 登 录 界 面 。 另 外 ， 此 Activity 类 也 将 作为 7.1.3 节 中 常规 程序 开发 的 示例 。 


表 7-1 微 博 实例 界面 控制 类 


类 库 名 入 口 


使 用 说 明 


com.app.demos.ui.UiLogin 是 登录 界面 ， 整 个 应 用 的 总 人 口 
com.app.demos.ui.UiIndex f 微 博 主 界面 ， 也 是 微 博 列表 界面 
com.app.demos.ui.UiBlog f 微 博 详情 界面 ， 即 点 击 单条 微 博 所 打开 的 界面 
com.app.demos.ui.UiBlogs f 微 博 列表 界面 ， 在 本 应 用 中 是 我 的 微 博 列表 
com.app.demos.ui.UiConfig T 应 用 配置 界面 ， 包 括 签名 设置 、 头 像 设 置 等 
com.app.demos.ui.UiEditText f 普通 编辑 界面 ， 用 于 普通 文本 的 编辑 
com.app.demos.ui.UiEditBlog T 微 博 编辑 界面 ， 用 于 微 博 内 容 的 编辑 
com.app.demos.ui.UiSetFace f 头像 设置 界面 
com.app.demos.demo.DemoWeb E 网 页 示例 界面 
com.app.demos.demo.DemoMap f 地 图 示例 界面 
com.app.demos.test.TestUi f 测试 示例 界面 

7.1.3 ”常规 程序 开发 与 调试 


学 习 了 应 用 配置 之 后 ， 接 下 来 我 们 就 要 开始 开发 应 用 程序 。 与 介绍 服务 端 程序 开发 的 思路 一 样 ， 我 们 在 开始 深入 讲解 整个 程序 的 功能 逻辑 之 前 ， 先 拿 个 典型 实例 做 一 次 剖析 ， 让 大 家 了 解 Android 程 序 


开发 的 基本 思路 和 开发 步 又。 为 了 让 大 家 更 直观 地 了 解 整个 系统 ， 我 们 选择 


对 于 所 有 以 MVC 作 为 设计 思路 的 系统 来 说 ， 控 制 器 是 所 有 功能 逻辑 的 核心 所 在 ; 同样 的 ， 对 于 Android 应 用 
anifest.xml ( 见 代码 清单 7-19) 中 ， 我 们 可 以 看 到 用 户 登 录 界 面 的 Activity 控 制 器 类 ( 即 UiLogin 类 ) 被 定义 为 整个 微 博 应 用 的 入 口 ; 也 就 是 说 ， 
控制 器 进行 处 理 。 接 下 来 ， 我 们 先 来 看 看 UiLogin 类 的 完整 代码 ， 见 代码 清单 7-20。 另 外 ，UiLogin 登 录 界 


AndroidM 


外 注意 。 


户 看 到 的 第 一 个 界面 ( 即 登录 界面 ) 来 做 案例 。 


代码 清单 7-20 


开发 来 说 ， 界 面 控制 器 的 开发 就 是 我 们 学 习 的 首要 任务 。 在 前 面 的 微 博 应 用 项 目 配置 文件 
户 点 击 微 博 应 用 图 标的 时 候 ， 系 统 会 先 交 由 该 


网 


控制 器 类 是 微 博 应 用 中 最 重要 的 界面 逻辑 类 之 一 ， 后 面 会 多 次 使 用 该 类 代码 作为 范例 ， 大 家 要 格 


package com.app.demos.ui; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


java.util.HashMap; 
android.content.Context; 
android.content.SharedPreferences; 
android.os.Bundle; 
android.view.KeyEvent; 
android.view.View; 
android.view.View.OnClickListener; 
android.widget .CheckBox; 
android.widget .CompoundBut ton; 
android.widget .EditText; 
com. app.demos .R; 
com. app. demos .base.BaseAuth; 
com. app . demos .base.BaseMessage; 
com.app.demos.base.BaseService; 
com.app.demos.base.BaseUi; 
com.app.demos.base.C; 
com. app. demos .model.Customer; 
com. app.demos.service.NoticeService; 
class UiLogin extends BaseUi { 
private EditText mEditName; 
private EditText mEditPass; 
private CheckBox mCheckBox; 
private SharedPreferences settings; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
// 已 登录 则 切换 至 首页 
if (BaseAuth.isLogin()) { 
this. forward (UiIndex.class) ; 


l 
// 设置 登录 界面 模板 ， 对 应 文件 res/layout/ui_login.xml 
setContentView(R.layout.ui login); 
// 控件 对 象 初始 化 以 及 记 住 密码 区 辑 实现 
mEditName = (EditText) this.findViewById(R.id.app login edit name); 
mEditPass (EditText) this.findViewById(R.id.app login edit pass); 
mCheckBox (CheckBox) this.findViewById(R.id.app login check remember); 
settings = getPreferences (Context.MODE PRIVATE); = n zi 
if (settings.getBoolean("remember", false)) { 

mCheckBox. setChecked (true) ; 

mEditName.setText (settings.getString("username", "")); 


mEditPass.setText (settings.getString("password", "")); 


l 
// 为 记 住 密码 CheckBox 控 件 设置 选中 状态 变化 监听 器 
mCheckBox.setOnCheckedChangelistener (new CheckBox.OnCheckedChangeListener () { 
GOverride 
public void onCheckedChanged (CompoundButton buttonView, boolean isChecked) { 
SharedPreferences.Editor editor = settings.edit(); 
if (mCheckBox.isChecked()) ( 
editor.putBoolean "remember", true); 
editor.putString("username", mEditName.getText ().toString()); 
editor.putString("password", mEditPass.getText ().toString()); 
) eise ( 
editor.putBoolean("remember", false); 
editor.putString("username", ""); 
editor.putString("password", ""); 
} 


editor.commit () 7 


} 
h); 
// 为 登录 Button 控 件 设置 点 击 事件 监听 器 
OnClickListener mOnClickListener = new OnClickListener() { 
GOverride 
public void onClick(View v) ( 
switch (v.getId()) { 
case R.id.app login btn submit : 
doTaskLogin () 7 
break; 


} 
] 
findViewById(R.id.app login btn submit).setOnClickListener (mOnClickListener) ; 
} 
Private void doTaskLogin() { 
// 输入 不 为 空 时 才 进行 网 络 请 求 
if (mEditName.length() > 0 && mEditPass.length() > 0) { 
HashMap<String, String> urlParams = new HashMap<String, String>(); 
urlParams.put ("name", mEditName.getText () .toString()); 
urlParams.put ("pass", mEditPass.getText () .toString()); 
try { 
this.doTaskAsync(C.task.login, C.api.login, urlParams) ; 
} catch (Exception e) { 
e.printStackTrace () ; 
} 


} 
//////////////////////////////////////////////////////////////////////////// 
// 异步 回调 方法 这些 方法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 
GOverride 
public void onTaskComplete(int taskId, BaseMessage message) { 

super.onTaskComplete (taskId, message); 

switch (taskId) { 

case C.task.login: 
Customer customer - null; 


// 登录 逻辑 

try ( 
customer = (Customer) message.getResult ("Customer"); 
// 登录 成 功 
if (customer.getName() != null) { 


BaseAuth. setCustomer (customer); 
BaseAuth.setLogin (true); 

// 登录 失败 

) else ( 
BaseAuth.setCustomer (customer); // set sid 
BaseAuth.setLogin (false) ; 
toast(this.getString(R.string.msg loginfail)); 

J 

} catch (Exception e) { 
e.printStackTrace(); 
toast (e.getMessage () ) ; 


l 
// 切换 至 首页 
if (BaseAuth.isLogin()) { 
// 启动 NoticeService 
BaseService.start (this, NoticeService.class); 
// 跳 转 至 应 用 首页 
forward (UiIndex.class); 
} 
break; 
} 
l 
GOverride 
public void onNetworkError (int taskId) { 
super.onNetworkError (taskId); 


} 
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// 其 他 界面 方法 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) ( 
if (keyCode == KeyEvent.KEYCODE BACK && event.getRepeatCount() == 0) í 
doFinish(); 


} 


return super.onKeyDown (keyCode, event); 


UiLogin 类 的 代码 比较 长 ， 涉 及 的 知识 点 也 比较 多 ， 为 了 便于 大 家 理解 ， 我 们 按照 由 上 至 下 的 阅读 顺序 ， 把 该 类 中 比较 重要 的 知识 点 剖析 归纳 如 下 。 


1. 包 声明 


UiLogin 是 个 标准 的 Java 类 ， 程 序 的 最 顶部 声明 了 该 类 所 处 的 包 名 ， 即 com.app.demos.ui (程序 包 说 明 见 表 5-2) ， 接 着 是 需要 导入 的 包 ， 这 些 类 包 分 为 三 大 类 : 首先 是 以 java 开 头 的 ， 这 些 是 Java 语 
言 的 原生 类 ; 其 次 是 以 android 开 头 的 ， 这 些 类 则 是 属于 Android 系 统 的 ; 最 后 是 以 com.app.demos 开 头 的 ， 这 些 类 都 是 属于 应 用 程序 基础 框架 中 的 。 


2. 类 声明 


所 有 的 界面 控制 器 类 都 是 以 Ui 为 前 缀 的 (类 命名 参考 5.2.2 节 ) ，UiLogin 也 一 样 ， 这 种 命名 方式 的 好 处 是 简单 直观 、 便 于 理解 。 其 次 ，UiLogin 是 BaseUi 的 子 类 ， 因 此 在 UiLogin 中 我 们 可 以 很 方便 地 使 
所 有 BaseUi 基 类 中 的 方法 ， 这 些 方法 我 们 在 5.2.2 节 中 已 经 详细 介绍 过 ， 学 习 过 程 中 若 记 不 得 ， 可 以 返回 查阅 。 


3. 类 属性 


UiLogin 类 有 4 个 属性 : 两 个 文本 输入 框 (EditText) 对 象 mEditrName 和 mEditPass， 分 别 与 登录 界面 上 的 用 户 名 和 密码 的 文本 输入 框 相对 应 ; 一 个 复 选 框 (CheckBox) 对 象 mCheckBox， 用 于 选择 
开启 或 关闭 记 住 密码 功能 ; 此 外 ， 还 有 一 个 SharedPreferences 对 象 ， 用 于 存储 是 否 记 住 密码 的 数值 。 我 们 可 以 看 到 ， 这 些 属性 值 实际 上 已 经 覆盖 了 登录 界面 所 具备 的 功能 ， 这 种 把 界面 上 需要 操作 的 UI 组 
件 声明 为 界面 控制 器 属性 的 方法 是 我 们 经 常用 到 的 。 


4.onCreate 方 法 


登录 界面 的 初始 化 方法 ， 登 录 控 制 器 中 最 重要 的 方法 之 一 ， 该 方法 里 面 的 逻辑 会 在 界面 初始 化 时 被 执行 ， 我 们 按照 逻辑 顺序 把 主要 逻辑 分 析 一 下 。 首 先 ， 使 用 基础 验证 类 BaseAuth 中 的 isLogin 方 法 来 
判断 用 户 是 否 已 经 成 功 登录 ， 若 是 切换 至 微 博 首页 界面 ， 否 则 就 往 下 执行 。 然 后 ， 使 用 setContentView 方 法 来 指定 界面 对 应 的 UI 模板 ， 这 里 指定 的 模板 为 R.layout.ui_login， 对 应 的 是 res/layout/ 目 录 下 面 
的 ui_login.xml 文 件 。 接 下 来 ， 使 用 findViewByld 方 法 ， 通 过 控件 id 来 获取 并 初始 化 控件 对 象 ， 包 括 用 户 名 文本 输入 框 (mEditName) 、 密 码 文本 输入 框 (mEditPass) 以 及 记 住 密码 复 选 杠 

(mCheckBox) 等 UI 控件 对 象 ， 并 且 使 用 mCheckBox 复 选 框 对 象 的 setOnCheckedChangeListener 方 法 设置 CheckBox 控 件 点 击 监听 器 对 象 CheckBox.OnCheckedChangeListener， 并 在 该 对 象 的 


onCheckedChanged 方 法 中 实现 了 CheckBox 控 件 点 击 事件 的 逻辑 。 最 后 ， 程 序 获取 到 登录 按钮 的 控件 对 象 ， 并 使 用 setOnClickListener 方 法 设置 了 Button 控 件 的 点 击 监听 器 对 象 OnClickListener， 并 在 
对 象 的 onClick 方 法 中 实现 了 Button 控 件 点 击 事件 的 逻辑 。 


5.doTaskLogin 方 法 


前 面 介 绍 到 登录 按钮 的 点 击 事件 ， 我 们 从 按钮 点 击 监听 器 对 象 的 onClick 方 法 逻辑 中 了 解 到 ， 当 用 户 点 击 登录 按钮 之 后 就 会 触发 doTaskLogin 方 法 来 发 送 请 求 。 在 UiLogin 类 中 ， 该 方法 使 用 界面 控制 器 
基 类 BaseUi 中 的 doTaskAsyn<c 方 法 来 发 送 异步 请 求 到 服务 端的 登录 接口 进行 登录 操作 。 


6.onTaskComplete 方 法 


于 接收 和 处 理 异 步 请 求 结果 的 回调 方法 ， 此 方法 是 与 doTaskAsync 方 法 对 应 的 一 套 方法 。 在 UiLogin 类 中 ， 此 方法 会 从 服务 端 接口 返回 的 JSON 消 息 中 解析 出 Customer 对 象 ， 如 果 Customer 对 象 的 
户 名 存在 则 提示 “登录 成 功 ”， 保 存 登 录用 户 信息 并 切换 到 微 博 首页 界面 ;否则 提示 “登录 失败 ”， 记 录 下 Session 1D 用 于 以 后 的 网 络 访问 。 


7.onNetworkError 方 法 


网 络 失败 时 执行 的 回调 方法 ， 此 方法 也 在 界面 控制 器 基 类 BaseUi 中 定义 ， 默 认 绊 出 网 络 失败 提示 ， 提 示 文 字 对 应 的 常量 名 为 C.err.network， 我 们 可 以 在 项 目 基础 类 包 com.app.demos.base 中 的 Cjava 
文件 中 找到 该 常量 。 当 然 ， 我 们 也 可 以 根据 需要 来 重 写 onNetworkError 方 法 。 


小 贴 士 : Cjava 是 用 于 定义 应 用 中 所 有 常量 的 类 ， 和 Android 应 用 框架 中 的 R.java 有 点 类 似 。 只 不 过 R.java 中 存储 的 是 Android 项 目 资源 文件 的 引用 常量 ， 是 系统 自动 生成 的 ; 而 C.java 存 储 的 是 程序 中 所 要 用 
到 的 常量 ， 是 由 我 们 自己 来 维护 的 。 


8.onKeyDown 方 法 


Ej 


于 捕获 并 处 理 UI 界 面 中 的 按键 事件 ， 此 方法 属于 Android 应 用 框架 的 原生 方法 。 它 包含 两 个 参数 : 第 一 个 参数 是 int 值 ， 用 于 判断 按 下 的 是 哪个 键 ; 第 二 个 参数 是 KeyEvent 按 键 事件 ， 则 用 于 捕获 按键 
触发 的 事件 。 这 里 的 逻辑 是 ， 在 登录 界面 中 按 下 后 退 按钮 就 关闭 程序 。 其 中 ， 后 退 按钮 是 用 KeyEvent.KEYCODE_BACK 常 量 来 表示 ， 而 关闭 方法 doFinish 则 是 在 BaseUi 中 定义 的 。 


lm 


至 此 ， 我 们 已 经 把 登录 界面 控制 器 的 主要 逻辑 解析 完毕 ， 不 过 Ul 界 面 的 展示 还 需要 模板 的 配合 才 可 ， 所 以 我 们 就 来 看 一 下 登录 界面 对 应 的 XML 模板 代码 ， 也 就 是 res/layout/ 目 录 下 的 ui login.xml 文 
件 ， 见 代码 清单 7-21。 


代码 清单 7-21 


<?xml version="1.0" encoding-"utf-8"?» 
«merge xmlns:android="http://schemas.android.com/apk/res/android"> 
<include layout="@layout/main_load" /> 
<LinearLayout 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:padding="30dip" E 
android:background-"(drawable/xml login bg"» 
<TextView ul I 
android:layout width-"wrap content" 
android:textAppearance-"?android:attr/textAppearanceLarge" 
android: layout_height="wrap_content" 
android: layout_gravity="center_ horizontal" 
android: text="@string/login title" 
android: layout_margin="20dip" 
android: textSize="10pt"/> 
<RelativeLayout 
android: layout_width="fill parent" 
android: layout _height="wrap_content"> 
<TextView = = 
android: layout width-"wrap content" 
textAppearance-"?android:attr/textAppearanceLarge" 


androii ayout height-"wrap content" 
android:text-"8string/login username" 
android:textSize-"l10pt" 


android:layout marginTop-"5dip"/» 
«EditText n 
android:layout weight-"1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:id="@+id/app login edit name" 
android:layout marginLeft-"60dip"/» 
</RelativeLayout> 
<RelativeLayout 
android: layout width-"fill parent" 
android: layout_height="wrap_content"> 


<TextView 
android: layout width-"wrap content" 
androi: extAppearance="?android:attr/textAppearanceLarge" 
androi: ayout height-"wrap content" 
android:text-"üstring/login password" 
android:textSize-"10pt" 


android: layout_marginTop="5dip"/> 
<EditText 
android: layout_weight="1" 
android: layout_width="fill parent" 
android: layout height-"wrap content" 
android: inputType="text Password" 
android:id="@+id/app login edit pass" 
android: layout_marginLeft="60dip"/> 
</RelativeLayout> 
<RelativeLayout 
android: layout width-"fill parent" 
android: layout_height="wrap_content"> 
<CheckBox T = 
android: layout width-"wrap content" 
android: layout height-"wrap content" 
android: textColor="@color/text" 
android: text="@string/login_remember" 
android:id="@+id/app login check remember 
android: layout_marginLeft="60dip"/> 
<Button x. 
android:id="@+id/app_login btn submit" 
android:layout height-"wrap content" 
android:text-"Gstring/login submit" 
android:layout width-"100dip" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true"/» 
</RelativeLayout> 
</LinearLayout> 
</merge> 
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观察 该 模板 的 结构 ， 我 们 发 现 登 录 界 面 由 上 至 下 大 致 可 分 为 4 行 。 首 行 最 简单 ， 只 有 一 个 TextView 元 素 ， 用 于 显示 “用 户 登 录 ” 文 字 ; 后 面 三 行 都 是 以 RelativeLayout 布 局 来 实现 ， 因 为 该 布局 使 用 起 
来 最 简洁 (关于 RelativeLayout 布 局 的 介绍 请 参考 2.7.2 节 ) 。 我 们 采用 类 似 于 HTML 布 局 的 写法 来 处 理 布 局 中 控件 的 排 布 。 当 然 ， 布 局 中 的 控件 和 之 前 介绍 的 UiLogin 类 中 的 属性 对 象 是 必须 对 应 上 的 ， 登 录 
的 最 终 UI 效 果 如 图 7-2 所 示 。 
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图 7-2 ” 微 博 登录 界面 


在 阅读 模板 文件 代码 的 时 候 ， 除 了 注意 布局 和 控件 的 组 合 使 用 ， 还 要 注意 一 些 常用 属性 的 用 法 。 比 如 宽 (android: layout width) 、 高 (android: layout height) 、 字 体 (android: textSize) 、 
背景 (android: background) 、 边 界 (android: layout margin) 以 及 位 置 (android: layout gravity) 等 ， 这 些 属性 的 用 法 可 以 参考 2.7.1 节 的 内 容 。 另 外 ， 我 们 要 注意 到 登录 界面 的 渐变 背景 使 用 的 
并 不 是 背景 图 ， 而 是 形状 控件 Shape，Android 系 统 中 给 我 们 提供 了 这 种 控件 ， 用 来 泻 染 出 简单 的 图 形 和 颜色 因为 这 种 方式 比 图 片 更 高 效 也 更 轻 量 ， 所 以 也 是 我 们 比较 推荐 的 一 种 用 法 。 


“@drawable/xml login_bg” 对 应 的 形状 控件 是 resdrawable/xml_login_bg.xml 文 件 ， 详 见 代码 清单 7-22。 


代码 清单 7-22 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android"> 
<gradient 
android:startColor="@color/bg" 
android:centerColor="@color/white" 
android:endColor="@color/bg" 
android:angle="270" 
android:centerY="0.3" /> 
<corners android:radius="0dip" /> 
</shape> 


ADT 环 境 给 我 们 提供 了 方便 的 Ul 界 面 调试 工具 ， 当 我 们 打开 某 个 模板 文件 时 ， 默 认 打开 的 是 界面 调试 工具 的 图 形 模式 (Graphical Layout) ， 比 如 我 们 打开 ui _login.xml 模 板 文件 时 ， 界 面 调试 工具 界 
面 的 截图 如 图 7-3 所 示 。 我 们 也 可 以 选择 界面 底部 的 “Graphical Layout” 和 “ui _login.xml” 来 切换 图 形 模式 和 XML 源 代码 模式 。 一 般 来 说， 我 们 会 在 源 代 码 模式 下 修改 模板 的 XML 代码 ， 然 后 在 图 形 模式 
形 模式 下 已 经 给 我 们 提供 了 左 侧 常用 的 空间 选择 菜单 ， 但 是 这 种 方式 并 不 推荐 大 家 使 用 ， 一 方面 由 于 生成 的 代码 不 易 控 制 ， 另 一 方面 也 不 利于 大 家 学 习 XML 模 板 的 语法 。 
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下 观察 显示 效果 ， 虽 然 
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图 7-3 ” 微 博 登录 预览 界面 


在 调试 完 登 录 界 面 的 UI 之 后 ， 我 们 就 可 以 打开 Android 模 拟 器 ， 并 把 项 目 程序 发 布 到 上 面 ， 观 察 登录 界面 的 最 终 运行 效果 ， 模 拟 器 上 的 运行 效果 如 图 7-4 所 示 。 当 然 ， 如 果 你 还 不 知道 如 何 发 布 和 运行 


Android 应 用 ， 请 参考 2.10.2 节 中 的 内 容 。 


接着 ， 我 们 来 讲 一 下 Android 程 序 逻 辑 的 调试 方法 。 在 2.10.3 节 中 我 们 曾经 简单 介绍 了 一 些 ADT 配 套 调试 工具 DDM SS 的 常见 用 方法 ， 包 括 文件 浏览 器 (File Explorer) 、 设 备 调试 信息 窗口 LogCat 等 。 
这 里 我 们 结合 登录 程序 的 逻辑 来 介绍 该 工具 中 更 高 级 的 一 些 用 法 。 首 先是 线程 查看 器 (Threads) ， 我 们 在 DDMS 界 面 左边 的 Devices 设 备 详情 窗口 中 选中 正在 运行 的 微 博 应 用 进程 ， 即 com.app.demos， 
然后 选中 上 面 的 查看 进程 按钮 ， 就 可 以 在 右边 的 Threads 标 签 窗口 中 找到 微 博 应 用 进程 下 面 的 所 有 线程 的 信息 。 运 行 效果 见 图 7-5 所 示 。 


接 下 来 是 内 存 查看 器 (Heap) ， 同 样 选中 正在 运行 的 微 博 应 用 进程 ， 然 后 选中 上 面 的 查看 进程 按钮 (绿色 的 小 圆柱 ) ， 便 可 以 在 右边 的 Heap 标 签 窗口 中 查看 微 博 应 用 进程 的 内 存 使 用 的 最 新 信息 与 详 
情 。 其 中 ， 我 们 要 特别 注意 其 中 Type 为 “data object” 的 数值 ， 也 就 是 我 们 进程 存在 的 所 有 类 型 对 象 的 内 存 占用 ， 此 数值 通常 用 来 判断 是 否 存在 内 存 泄漏 。 运 行 效果 见 图 7-6 所 示 。 
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图 7-4 微 博 登录 界面 运行 效果 
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图 7-5 ”调试 界面 线程 查看 器 
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图 7-6 ”调试 界面 内 存 查看 器 


最 后 是 资源 分 配 跟踪 器 (Allocation Tracker) ,同样 选中 正在 运行 的 微 博 应 用 进程 ， 然 后 在 右边 的 “Allocation Tracker” 标 签 窗口 中 点 击 “Start Tracking” ， 即 开始 跟踪 按钮 ， 就 可 以 在 下 方 的 列 
表 中 查看 到 准确 的 数据 存储 结构 的 内 存 分 配 ， 该 工具 可 以 让 我 们 了 解 程序 运行 过 程 中 的 内 存 分 配 情况 ， 对 程序 调试 是 非常 有 用 的 。 运 行 效果 见 图 7-7 所 示 。 
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图 7-7 调试 界面 资源 分 配 跟踪 器 


本 节 以 登录 界面 为 例 ， 介 绍 了 在 常规 Android 应 用 程序 开发 中 ， 程 序 逻 辑 是 如 何 与 界面 模板 结合 起 来 ， 最 终 组 合成 UI 界面 并 运行 的 过 程 ， 另 外 ， 我 们 还 介绍 了 如 何 使 用 DDMS 工 具 进 行程 序 调试 的 常 
方法 。 这 些 内 容 都 是 Android 应 用 开发 中 需要 掌握 的 基础 知识 ， 大 家 在 学 习 理 解 的 同时 最 好 能 动手 实践 一 下 。 


7.2 ”界面 布局 和 行为 控制 


界面 显示 是 Android 应 用 客户 端 最 主要 的 职责 之 一 ， 而 界面 布局 则 是 其 中 最 重要 的 基础 知识 之 一 。 在 2.7.2 节 中 我 们 认识 了 Android UI 系统 中 常见 的 几 种 布局 ， 包 括 基 本 布局 (FrameLayout) 、 线 性 布 
局 (LinearLayout) 、 相 对 布局 (RelativeLayout) 、 绝 对 布局 (AbsoluteLayout) 、 表 格 布局 (TableLayout) 、 标 签 布局 (TabLayout) 等 。 每 个 布局 都 有 各 自 的 特点 ， 也 有 自己 相对 合适 的 使 用 场 
景 ， 因 此 我 们 要 根据 实际 的 情况 来 决定 比较 合理 的 布局 策略 ， 一 个 良好 的 布局 方式 不 仅 可 以 简化 界面 的 开发 ， 还 可 以 提高 程序 的 执行 效率 。 


另外 ， 对 于 应 用 客户 端 来 说， 如 何 控制 用 户 的 行为 也 是 非常 重要 的 。 假 设 我 们 的 应 用 界面 非常 绚丽 ， 但 是 操作 起 来 很 不 方便 ， 那 么 这 个 作品 无 疑 是 失败 的 。 在 这 个 问题 上 ， 我 们 经 常 提 到 的 一 个 词 
是 “人 性 化 ”， 也 就 是 让 使 用 更 贴近 于 普通 人 的 操作 习惯 。 当 然 ， 同 时 具有 漂亮 外 观 和 人 性 化 操作 的 设计 必定 可 以 给 应 用 加 分 不 少 。 


7.2.1 使 用 Layout 布 局 


界面 设计 是 一 门 艺 术 ， 通 常 我 们 都 会 有 专门 的 设计 师 来 做 这 方面 的 工作 ， 但 是 从 设计 到 实现 的 工作 还 是 得 由 开发 工程 师 们 来 完成 ; 准确 来 说， 这 个 过 程 就 是 从 原型 设计 到 XML 模板 代码 的 制作 和 实现 过 
程 。5.3.2 节 中 我 们 已 经 完成 了 微 博 应 用 主要 UI 界面 的 原型 设计 ， 包 括 用 户 登录 、 微 博 列表 、 微 博 正文 、 我 的 微 博 列表 以 及 用 户 配置 界面 。 下 面 我 们 会 从 中 挑选 一 些 比较 有 代表 性 的 界面 作为 例子 讲解 一 下 使 
Layout 控 件 来 进行 布局 的 思路 。 


之 前 我 们 简单 介绍 过 微 博 应 用 的 用 户 登录 界面 ， 该 界面 的 元 素 不 多 、 设 计 简单 ， 但 是 比较 特殊 ， 没 有 通用 性 。 然 而 ， 用 户 登录 之 后 看 到 的 微 博 界面 却 大 不 一 样 ， 这 些 界面 相对 比较 复杂 ， 不 过 却 有 统一 
的 模板 。 下 面 ， 我 们 先 以 微 博 列表 界面 (也 就 是 登录 之 后 的 第 一 个 界面 ) 为 例 ， 如 图 7-8 所 示 。 该 界面 大 致 分 为 上 、 中 、 下 三 个 板块 ， 分 别 为 顶部 的 导航 栏 、 中 部 的 微 博 列表 和 底部 的 功能 选项 栏 ， 对 应 的 模 


板 文件 是 res/layout/ 目 录 下 的 ui_index.xml， 详 见 代 码 清单 7-23。 


a index.xnl 7 
ds 


图 Graphical Layout >| app indez.zml 
AIS 微 博 列表 预览 界面 


代码 清单 7-23 


Editing config: default Any locele | Android 3.0 v 
3.Tin WVGA (Hexas One) v | Portrait v | Nornal v | Day time v| con. app. denoz. theme. light w 
=| Palette v = = ü ae 
ORES ee | | 
wxwww Large Medium xn | | 
demos 
Button OFF [Z] checkbox *— = ° e] 
: Item 1 
$) RadioButton CheckedTextView sub ltem 1 
Item 2 
"Uoc — Sub wem 2 
| 
— | 
~ Item 3 
C Sub Ttem 3 
AÁ 
«Item 4 $ 
s ; , sub Ttem 4 
Item 5 
| sub Item 5 
C Text Fields 
[ Layouts Item 6 
[ Composite Sub'item 6 
(> Images å Hadia 
= em 7 
| Time & Date It m 
| sSubdiem 7 se 
| Transitions | 
[ Advanced 3 
Custom è Library Views | 3 


«?xml version-"1.0" encoding-"utf-8"?» 
«merge xmlns:android="http://schemas.android.com/apk/res/android"> 
«include layout="@layout/main_layout" /> 
<LinearLayout 

android: orientation="vertical" 

android: layout_width="fill parent" 

android: layout_height="fill_parent"> 

<include layout="@layout/main_top" /> 

<LinearLayout 

android: orientation=" i 


<ListView 
android: id="@+id/app_index_list_view" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:descendantFocusability-"blocksDescendants" 
android: fadingEdge="vertical" 
android: fadingEdgeLength="5dip" 
android:divider="@null" 
android: listSelector="@drawable/xml_list_bg" 
android: cacheColorHint="#00000000" 7» ~ 
</LinearLayout> 
<include layout="@layout/main_tab" /> 
</LinearLayout> T 
</merge> 


值 
们 
框 
的 


经 


下 面 开 始 讲解 微 博 列表 界面 的 布局 思路 。 首 先 ， 可 以 看 出 该 界面 的 整体 布局 是 纵向 的 ， 所 以 我 们 使 用 垂直 的 线性 布局 来 作为 整个 界 
都 是 fill_parent。 接 下 来 看 看 内 部 的 布局 ， 这 里 先 不 讨论 界面 项 部 和 底部 的 板块 ， 着 重 观察 中 间 的 微 博 列表 ， 也 就 是 图 7-8 中 蓝 色 框 的 部 分 。 由 于 微 


面 的 外 框 ， 当 然 ， 此 布 


只 需要 使 用 最 基本 的 线性 布局 (LinearLayout) 来 划 出 微 博 列表 的 外 框 即 可 ; 由 于 ListView 一 般 是 纵向 的 ， 所 以 线性 布局 也 必须 是 垂直 的 ， 这 里 我 人 


。 不 过 ， 可 以 观察 到 此 处 的 线性 布局 的 高 度 与 前 者 不 同 ， 它 的 属性 值 是 wrap_content， 配 合 android: layout weight 属 性 值 为 1 的 情况 ， 表 示 界 画 


板块 较 低 ， 这 样 最 终 形成 了 微 博 列表 界面 上 、 中 、 下 的 布局 结 


& 


情 列 表 是 直接 使 


门 再 次 使 


中 间 的 微 | 


实际 上 ， 任 何 复杂 的 界面 都 可 以 被 逐步 拆 分 并 实现 出 来 ， 而 其 中 最 重要 的 秘诀 之 一 就 是 要 知道 如 何 灵活 使 用 Layout 布 局 来 组 装 界 


H] 


验 ， 接 下 来 我 们 再 以 更 复杂 的 微 博 详情 界面 (7.9.1 节 中 我 们 会 详细 介绍 ) 为 例 ， 进 一 步 讲解 布局 的 使 


7e 


。 之 前 我 们 以 微 博 列表 界面 为 例 ， 给 大 家 介绍 了 一 些 布局 方 画 


博 列 表 在 垂直 方向 的 伸 


REEL 


局 的 宽 高 必须 是 充满 整个 界面 的 ， 即 宽 高 属性 
ListView 列 表 控 件 来 实现 的 ， 所 以 我 
了 一 个 垂直 的 线性 布局 作为 微 博 列表 的 外 

顶部 和 底部 


思路 。 我 们 打开 ui_blog.xml 模 板 文件 ， 便 可 在 界面 调 


试 工具 中 看 到 该 界面 的 显示 效果 ， 如 


k app blog. xml 03 EL 


u oe ORTA AUS 


Editing config: default [Any locale Z| Android 3.0 `v 
3 Tin WGA (ias One) WlPortrait |a | v [Day time [con app. denos theme. Light B 


EI -| 0B [e 60- mm Aad aa 


i> Forma Widgets 


I 


Wwiew Large Medium n 


OFF 


Button [7] checkbox 


©) RadioButton CheckedTextView 


dd 


^ 写 评论 


(> Text Fields 

> Layouts 

(~ Composite 

> Images å Media 

| Tine & Date 

| Transitions 

(> Advanced 3 


Custom & Library Yiews 


图 Graphical Layout =| app blog. xnl 
图 7-9 微 博 详情 预览 界面 


下 面 介 绍 微 博 详情 界面 的 布局 思路 。 首 先 ， 同 样 不 讨论 界面 项 部 和 底部 的 板块 ， 着 重 观察 中 间 的 内 容 ， 我 们 会 发 现 这 部 分 内 容 还 可 以 分 为 上 、 下 两 部 分 ， 上 部 是 微 博 作者 的 信息 简介 ， 而 下 部 则 是 微 博 
内 容 以 及 评论 内 容 的 列表 信息 。 其 次 ， 上 部 的 信息 简介 部 分 内 空间 元 素 排列 比较 灵活 ， 因 此 我 们 可 以 使 用 相对 布局 (RelativeLayout) 来 实现 ; 而 下 部 都 是 列表 形式 的 内 容 ， 因 此 我 们 更 倾向 使 用 垂直 线性 
布局 (LinearLayout) 配合 ListView 列 表 来 实现 。 实 际 上 ， 我 们 也 正 是 这 样 做 的 。 微 博 详 情 界面 的 实现 细节 我 们 会 在 后 面 的 7.9.1 节 中 做 详细 解析 ， 本 节 暂 时 只 讨论 布局 思路 的 问题 。 


通过 以 上 案例 的 分 析 ， 大 家 应 该 对 如 何 使 用 Layout 布 局 来 构造 应 用 的 UI 界面 有 所 认识 了 。 由 于 界面 模板 是 必须 在 程序 逻辑 之 前 准备 好 的 ， 所 以 这 部 分 的 知识 是 Android 应 用 开发 中 的 首要 技能 。 当 然 ， 
本 节 中 介绍 的 主要 是 设计 思路 ， 至 于 具体 的 技术 细节 和 技巧 ， 接 下 来 我 们 还 会 在 后 面 微 博 功能 界面 的 实现 过 程 中 穿插 介绍 到 。 


7.2.2 ”使 用 Merge 整 合 界面 


对 于 典型 的 Android 应 用 来 说 ， 很 多 的 功能 界面 都 具有 通用 性 ， 我 们 可 以 对 比 一 下 微 博 应 用 登录 之 后 的 几 个 主要 界面 ， 包 括 微 博 列表 、 微 博 正文 、 我 的 微 博 列表 以 及 用 户 配置 等 ， 都 是 典型 的 上 、 中 、 
下 结构 ， 并 且 顶 部 和 底部 都 属于 公用 板块 ， 其 内 容 也 都 非常 类 似 。 在 这 种 情况 下 我 们 就 会 考虑 使 用 某 种 方式 把 公共 部 分 的 模板 代码 提取 出 来 ， 这 样 不 仅 可 以 大 大 减少 重复 编码 ， 还 可 以 简化 视图 层级 ， 提 升 
运行 效率 。 而 <merge/> 标 签 的 出 现 就 是 专门 用 于 应 对 这 种 情况 的 ， 图 7-10 中 展示 的 就 是 使 用 <merge/> 标 签 来 整合 典型 Android 应 用 界面 的 思路 ; 当然 ， 我 们 同样 可 以 把 这 种 思路 运用 到 微 博 应 用 的 界 画 


开发 工作 中 去 。 


图 7-10 使 用 <merge/> 标 签 整 合 界 面 


实际 上 ， 经 常 和 <merge/> 标 签 配合 使 用 的 还 有 <include/> 标 签 。 在 使 用 的 时 候 ，< merge/> 标 签 必 须 以 根 元 素 的 方式 出 现 ， 而 <include/> 则 用 于 包含 其 他 的 子 模板 。 比 如 之 前 提 到 的 微 博 列表 界面 
的 模板 (如 代码 清单 7-23 所 示 ) ， 如 果 没 有 使 用 Merge 和 Include 标 签 来 处 理 的 话 ， 其 模板 的 XML 代码 是 不 可 能 如 此 简洁 的 。 之 前 我 们 并 没有 分 析 微 博 列表 界面 顶部 和 底部 的 公用 模板 ， 现 分 析 如 下 。 


首先 是 公用 板块 部 分 ， 也 就 是 “@layout/main_layout” 对 应 的 模板 ， 即 reslayout/ 目 录 下 的 main_layout.xml 文 件 ， 如 代码 清单 7-24 所 示 。 该 模板 包含 一 个 充满 全 屏 的 ImageView 图 像 控件 ， 作 为 微 
博 应 用 的 背景 ;以 及 一 个 包含 进度 条 控件 的 模板 ( 详 见 main_load.xml) ， 用 于 微 博 界面 处 理 时 的 等 待 效 果 。 另 外 ， 对 于 Android 的 模板 引擎 来 说 ， 先 被 包含 〈Include) 的 就 会 先 被 泻 染 ， 所 以 公用 板块 必 
须 在 最 前 面 被 包含 。 在 微 博 列表 界面 中 ， 公 用 模板 的 包含 代码 就 紧 接 在 <merge/> 标 签 之 后 。 


代码 清单 7-24 


<?xml version="1.0" encoding-"utf-8"?» 
«merge xmlns:androide"http://schemas.android.com/apk/res/android"» 
<!-- Background --> 
<ImageView 
android: layout_width="fill parent" 
android: layout height-"fill parent" 
android: background="@drawable/xml_main_bg" /> 
<!-- Loading bar --> 
<include layout="@layout/main_load" /> 
</merge> ul 


然后 是 顶部 导航 栏 的 部 分 ， 也 就 是 “@Ilayout/main_top” 对 应 的 模板 ， 即 reslayout/ 目 录 下 的 main_top.xml 文 件 ， 如 代码 清单 7-25 所 示 。 此 模板 包含 一 个 位 于 中 间 的 TextView 文 本 框 控件 ， 用 于 显 


示 界 面 名 称 ;以 及 一 个 关闭 按钮 ， 


代码 清单 7-25 


于 退出 应 


。 它 会 在 应 


<?xml version-"1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 


android: layout_height=" 


29dip" 


android:gravity-"center vertical" 
android:background-"8drawable/xml main top bg"> 


«Button 


android:id-"Q(*id/main top quit" 
android:layout width-"34dip" 
android:layout height-"29dip" 


android:layout alignParentRight-"true" 
android:background="@drawable/close_s" 


<TextView 


android: id="@+id/main top title" 
android: layout_width=" rw c 


android:layout heigh 


android:gravity-" 


center" 


android:singleLine-"true" 

android:ellipsize-"marquee" 
android:text="@string/app_name" 
android: textAppearance="?android:attr/textAppearanceMedium" /> 


</RelativeLayout> 


dip" 


界面 外 框 的 顶部 被 包含 ， 比 如 ， 在 微 博 列表 界 


/> 


面 中 ， 其 位 置 就 在 微 博 列 表 的 ListView 之 前 。 


接着 是 底部 的 功能 菜单 部 分 ， 也 就 是 “@layout/main_tab” 对 应 的 模板 ， 即 res/layout/ 目 录 下 的 main_tab.xml 文 件 ， 如 代码 清单 7-26 所 示 。 此 模板 是 横向 的 ， 并 排 排 列 着 4 个 不 同 图 像 表示 的 功能 按 


钮 ， 从 左 到 右 分 别 是 “ 微 博 列表 ” 


代码 清单 7-26 


“我 的 微 博 列表 ” 


“用户 配 置 ” 和 “撰写 微 博 ” 选 项 。 它 会 在 应 用 界 


面 外 框 的 底部 被 包含 ， 比 如 ， 在 微 博 列表 界面 中 ， 其 位 置 就 在 微 博 列表 的 ListView 之 后 。 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http: //schemas . android.com/apk/res/android" 


android:orientation- 


orizontal" 


android:layout width-"fill parent" 


android:layout height-" 
<ImageButton 


51dip"> 


android:id="@+id/main_tab 1" 

android:layout i width=". Wrap | content" 
android:layout height-"wrap content" 
android:layout weight-"1" 
android:src-"Gdrawable/tab blog 1" 
android:background-"Gdrawable/xml main tab bg" /> 


<ImageButton 


android: id="@+id/main_tab_2" 

android:layout i width=". Wrap | content" 
android:layout height-"wrap content" 
android:layout weight-"1" 
android:src="@drawable/tab heart 1" 
android:background-"8drawable/xml main tab bg" /> 


<ImageButton 


android: id="@+id/main_tab_3" 

android: layout_width="1 wrap content" 
android:layout height-"wrap content" 
android:layout _ weight-"1" 
android:src-"Gdrawable/tab conf 1" 
android:background-"Gdrawable/xml main tab bg" /> 


<ImageButton 


android: id="@+id/main tab 4" 

android: layout_width="\ wrap content" 
android:layout height-"wrap content" 
android:layout weight-"1" 
android: src="@drawable/tab_star_1" 


android:background="@drawable/xml_main_tab_bg" /> 


</LinearLayout> 


以 上 3 个 板块 ， 再 加 上 微 博 列表 的 ListView， 就 构成 了 完整 的 微 博 列表 界面 。 
模板 文件 的 大 小 估计 会 翻 上 几 番 了 。 然 而 , 使 用 了 <merge/> 和 


他 模板 文件 都 加 上 这 些 代码 的 话 ， 整 
也 应 该 多 多 加 以 运用 。 


7.2.3 ”使 用 Event 控 制 用 户 行为 


个 应 


an 


大 家 可 以 想象 一 下 ， 如 果 把 这 些 板 块 的 代码 加 入 到 ui_index.xml 之 中 ， 模 板 文件 将 会 变 得 多 么 宛 长 ; 假如 所 有 类 似 结构 的 其 


<include/> 标 签 之 后 ， 确 实 为 Android 应 用 界面 开发 提供 了 很 多 方便 和 好 处 ， 在 实际 项 目 中 我 们 


前 面 介绍 了 UI 控件 的 布局 ， 接 着 我 们 来 学 习 如 何 控制 与 UI 控件 相关 的 用 户 行为 ， 这 是 Android 应 用 与 用 户 交互 的 最 重要 途径 ， 也 是 我 们 必须 掌握 的 开发 技巧 。 通 过 2.7.3 节 对 Android UI 系统 事件 


(Event) 用 法 的 介绍 ,我 们 了 解 到 ， 在 Android 系 统 中 ， 所 有 UI 控件 的 动作 都 是 通过 事件 监听 器 Listener 来 控制 的 ， 而 UI 控件 的 基 类 View 视 图 类 为 我 们 提供 了 一 系列 设置 事件 监听 器 的 方法 ， 来 为 不 同 的 UI1 


控件 设置 对 应 的 监听 器 ; 接 下 来 ， 我 们 将 对 这 些 方法 中 比较 常 


1.setOnClickListener (View.OnClickListener I) 方法 


此 方法 用 于 设置 控件 被 点 击 时 触发 事件 的 
OnClickListener 监 听 器 中 的 程序 逻辑 。 另 外 ， 该 


监听 器 中 需要 程序 实现 的 


监听 器 。7.1.3 节 中 的 登录 界面 的 示例 代码 UiLogin 类 (REB 
象 方法 为 onClick (View v) ， 参 数 只 有 一 个 ， 就 是 被 点 击 的 控件 对 象 。 


2.setOnCreateContextMenuListener (View.OnCreateContextMenuListener |) 方法 


此 方法 用 于 设置 上 下 文 菜单 被 创 


建 时 触发 事 


件 的 监听 器 。 


也 就 是 说 ， 当 选中 控件 的 上 下 文 菜单 被 创建 时 ， 


的 几 个 进行 分 析 ， 其 实 我 们 从 Android SDK 中 可 以 了 解 到 更 详细 的 内 容 。 


青 单 7-20) 中 就 包含 了 此 方法 的 使 用 范例 ， 当 用 户 点 击 登录 按钮 之 后 就 会 触发 按钮 对 应 的 


将 触发 OnCreateContextMenuListener 监 听 器 中 的 程序 逻辑 ， 此 监听 器 中 需要 程序 实现 的 抽 


象 方法 为 onCreateContextMenu (ContextMenu menu, View v, ContextMenu.ContextMenulnfo menulnfo) ， 该 方法 的 3 个 参数 分 别 是 上 下 文 菜单 本 身 、 菜 单 附属 的 控件 对 象 以 及 菜单 显示 的 附加 


信息 。 


3.setOnFocusChangeListener (View.OnFocusChangeListener l) 方法 


此 方法 用 于 设置 控件 焦点 变化 时 触发 事件 的 


v, boolean hasFocus) ， 两 个 参数 分 别 是 控件 对 象 本 身 和 是 否 聚集 


监听 器 。 当 选中 控件 焦点 变化 的 时 候 将 触发 OnFocusChangeListener 监 听 器 中 的 程序 逻辑 ， 该 监听 器 中 需要 程序 实现 的 抽象 方法 为 onFocusChange (View 


4.setOnKeyListener (View.OnKeyListener I) 方法 


此 方法 用 于 设置 按键 触发 事件 的 监 


监听 器 。 


的 状态 值 ， 此 参数 常 与 一 些 文本 输入 控件 (如 EditText) 配合 使 用 。 


选中 控件 同时 按 下 键盘 的 时 候 将 触发 OnKeyListener 监 听 器 中 的 程序 逻辑 ， 该 监听 器 中 需要 程序 实现 的 抽象 方法 为 onKey (View v, int 


keyCode, KeyEvent event) ，3 个 参数 分 别 是 按键 时 选中 的 控件 对 象 ， 按 键 的 码 值 (keyCode) 以 及 按键 事件 。 当 然 ，Activity 类 本 身 已 经 包含 了 捕捉 按键 动作 的 onKeyDown 方 法 ; 5 


外 ，OnKeyListener 只 能 监听 硬 键盘 事件 ， 而 我 们 却 可 以 通过 使 用 TextWatcher 类 来 同时 监听 软 键盘 和 硬 键盘 的 响应 。 


小 贴 士 : TextWatcher 可 用 于 监控 用 户 输入 的 内 容 ， 经 常 与 EditText 控 件 配合 使 用 。 


此 类 通过 addTextChangedListenet 方 法 设置 ， 通 常 我 们 只 需要 实现 类 中 的 onTextChanged 方 法 即 可 。 此 外 ，TextWatcher 还 提 


供 了 beforeTextChanged 和 afterTextChanged 方 法 ， 用 于 处 理 更 加 细节 的 监听 逻辑 。 


5.setOnLongClickListener (View.OnLongClickListener |) 方法 


此 方法 用 于 设置 长 时 间 按 下 控件 时 触发 事件 的 监听 器 ， 用 法 和 之 前 介绍 的 setOnClick-Listener 方 法 基本 相同 ; 唯一 有 区 别 的 地 方 是 OnLongClickListener 监 听 器 中 需要 程序 实现 的 抽象 方法 的 方法 名 不 
大 一 样 ， 这 里 对 应 的 是 onLongClick 方 法 。 


6.setOnTouchListener (View.OnTouchListener l) 方法 


此 方法 用 于 设置 触 屏 事件 的 监听 器 。 对 于 目前 主流 的 移动 设备 来 说 ， 都 是 配备 触摸 屏 的 ， 所 以 触 屏 事件 的 运用 范围 非常 的 广泛 ; 另外 ， 对 于 和 触 屏 设备 来 说， 几乎 所 有 的 操作 都 是 通过 触 屏 来 实现 的 ， 也 
包括 之 前 提 到 的 点 击 、 按 键 等 操作 ， 所 以 在 使 用 触 屏 事件 的 时 候 一 定 要 特别 注意 避免 出 现 事件 的 覆盖 或 者 冲突 ， 一 般 来 疝 ， 如 果 已 经 在 控件 上 使 用 了 触 屏 事件 ， 就 不 建议 再 处 理 其 他 与 手势 操作 有 关 的 事件 
了 。 


触 屏 事件 监听 器 类 (OnTouchListener) 中 需要 程序 实现 的 抽象 方法 为 onTouch (View v, MotionEvent event) ， 两 个 参数 分 别 为 触摸 的 视图 控件 和 MotionEvent 动 作 事件 。 在 使 用 的 时 候 ， 我 们 可 
以 根据 使 用 MotionEvent 对 象 的 getAction 方 法 来 获取 事件 手势 来 进行 相应 的 处 理 ， 示 例如 代码 清单 7-27 所 示 ， 更 多 MotionEvent 手 势 相关 的 信息 请 参考 2.7.3 节 中 与 Event 事 件 有 关 的 内 容 。 


代码 清单 7-27 


OnTouchListener mTouchListener = new OnTouchlistener() ( 
GOverride 
public boolean onTouch(View v, MotionEvent event) ( 
// 获取 事件 手势 
switch (event.getAction()) ( 
case MotionEvent .ACTION_DOWN: 
// ATA ERE E 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
break; 
case MotionEvent.ACTION MOVE: 
// 拖 动手 势 触发 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
break; 
case MotionEvent .ACTION_UP: 
// 松 开 手势 触发 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
break; 
// ief He KS 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


return true; 


本 节 我 们 介绍 了 在 Android 应 用 开发 中 比较 常见 的 Event 事 件 的 使 用 方法 ， 在 实际 项 目 中 我 们 需要 对 不 同 的 控件 使 用 适合 的 事件 监听 器 来 处 理 触发 事件 ， 比 如 Button 按 钮 控件 上 ， 通 常会 
OnClickListener 点 击 事件 监听 器 ，EditText 文 本 输入 控件 则 经 常 与 按键 事件 监听 器 (OnKeyListener) 以 及 焦点 变化 监听 器 (OnFocusChangeListener) 有 关 。 另 外 ， 我 们 还 需要 注意 多 个 事件 之 间 覆 盖 或 
者 冲突 的 问题 ， 特 别 在 控件 之 间 出 现 重 亚 的 时 候 ; 如 果 需 要 处 理 相对 比较 复杂 的 动作 或 者 手势 ， 建 议 直接 使 用 触 屏 事件 OnTouchListener 来 处 理 。 


7.24 使 用 Intent 控 制 界 面 切换 


站 在 整个 应 用 的 角度 来 看 ， 一 个 标准 的 Android 应 用 通常 是 由 若干 个 功能 界面 构成 的 ， 当 我 们 要 使 用 不 同 的 功能 时 ， 就 必然 会 发 生 界面 切换 的 动作 ， 而 这 个 动作 通常 是 用 Intent 消 息 来 控制 的 ， 也 就 是 
说 Intent 消 息 的 重要 用 途 之 一 就 是 控制 界面 的 切换 。 在 2.3.2 节 中 我 们 曾经 介绍 过 Intent 消 息 的 基础 概念 以 及 常见 的 使 用 方式 ， 接 下 来 我 们 将 介绍 在 微 博 应 用 客户 端 实例 中 是 如 何 使 用 Intent 消 息 来 控制 界面 
切换 的 。 


首先 是 显 式 消息 的 使 用 方式 ， 也 就 是 通过 输入 指定 Activity 界 面 控制 器 类 的 class 对 象 来 实现 界面 切换 。 在 界面 控制 器 基 类 BaseUi 中 ， 我 们 可 以 查找 到 名 为 forward 的 两 个 方法 ， 如 代码 清单 7-28 所 示 。 
两 个 方法 的 功能 都 是 切换 到 目标 界面 ， 不 过 参数 不 同 ， 作 用 也 不 相同 。 当 然 ， 两 个 方法 都 需要 传 入 将 要 切换 到 的 Activity 界 面 控 制 器 类 的 class 对 象 。 不 过 第 二 个 方法 还 需要 传 入 Bundle 对 象 ， 用 于 保存 键 值 
对 (key-value) 类 型 的 值 ， 而 这 些 值 将 作为 参数 被 传递 到 目标 Activity 界 面 控制 器 类 中 。 


代码 清单 7-28 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public void forward (Class«?» classObj) ( T 
Intent intent = new Intent () 7 
intent.setClass (this, classObj); 
intent.setFlags (Intent.FLAG ACTIVITY CLEAR TOP); 
this.startActivity (intent); 
this.finish(); 


} 

public void forward (Class<?> classObj, Bundle params) { 
Intent intent = new Intent () 7 
intent.setClass (this, classObj); 
intent.setFlags (Intent.FLAG ACTIVITY CLEAR TOP); 
intent.putExtras (params); H 7 
this.startActivity (intent) ; 
this.finish(); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


这 种 界面 切换 方式 类 似 于 网 页 跳 转 ， 打 开 新 的 界面 然后 把 原先 的 界面 关 掉 ， 虽 然 简单 不 过 很 有 效 。 这 种 做 法 的 好 处 是 保证 应 用 的 Activity 推 栈 (请 参考 2.3.4 节 中 关于 Task 任 务 部 分 的 内 容 ) 中 只 保存 一 
个 ， 它 类 似 Task 模 式 中 的 singleTask， 可 以 简化 应 用 并 节省 较 多 的 内 存 ， 因 此 我 们 在 微 博 应 用 中 会 经 常 使 用 到 forward 方 法 。 例 如 ， 在 登录 界面 的 代码 UiLoginjava 中 ( 见 代 码 清单 7-20) ， 登 录 逻 辑 成 功 之 
后 我 们 就 会 使 用 “forward (Applndex.class) ; ”语句 把 应 用 切换 到 微 博 列表 界面 ， 实 际 上 无 论 我 们 在 界面 控制 器 的 任何 地 方 使 用 orward 方 法 ， 都 将 结束 当前 界面 并 切换 到 新 界面 中 去 。 


接 下 来 ， 我 们 顺便 来 学 习 隐 性 消息 的 实际 应 用 。 不 同 于 显 性 消息 的 使 用 方式 ， 隐 性 消息 不 需要 知道 要 切换 到 的 界面 类 的 class 对 象 ， 因 为 隐 性 消息 是 通过 设置 Intent 对 象 的 动作 Action 来 指定 需要 到 达 的 
目标 ， 比 如 在 界面 控制 器 基 类 BaseUi 中 ， 我 们 可 以 找到 两 个 名 为 doEditText 的 方法 ， 如 代码 清单 7-29 所 示 ， 这 两 个 方法 都 用 到 了 隐 性 消息 来 完成 界面 切换 以 及 传递 参数 的 功能 ， 其 作用 都 是 打开 编辑 界面 并 
进行 文本 输入 。 


m 


代码 清单 7-29 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void doEditText () { "s 
Intent intent = new Intent(); 
intent.setAction (C.intent.action.EDITTEXT); 
this.startActivity (intent); 


š 

public void doEditText (Bundle data) ( 
Intent intent = new Intent(); 
intent.setAction (C.intent.action.EDITTEXT) ; 


intent.putExtras (data); 
this.startActivity(intent); 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


首先 ， 这 里 setAction 方 法 的 参数 是 C.intent.action.EDITTEXT， 这 个 常量 我 们 可 以 在 程序 基础 类 包 com.app.demos.base 中 的 C.java 常 量 类 中 找到 对 应 的 定义 ， 如 代码 清单 7-30 所 示 ， 对 应 的 常量 值 是 
SAFER "com.app.demos.EDITTEXT" 。 


代码 清单 7-30 


public final class C { 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 

public static final class intent { i 
public static final class action { 

public static final String EDITTEXT 

public static final String EDITBLOG 


"com.app.demos.EDITTEXT"; 
"com.app.demos.EDITBLOG"; 
} 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


当然 ， 隐 性 消息 必须 和 配置 文件 中 的 <intent-filter/ > 标签 来 配合 使 用 。 大 家 可 以 在 应 用 的 配置 文件 中 查找 <intent-filter/ > 配置 中 的 Action 设 置 包含 字符 串 “com.app.demos.EDITTEXT” 的 Activity 元 
素 ， 即 名 为 “.app.AppEditText” 的 Activity 元 素 ， 如 代码 清单 7-31 所 示 。 实 际 上 ， 此 Activity 就 是 微 博 应 用 的 通用 文本 编辑 界面 ， 在 “发 表 评论 ”和 “修改 签名 ”功能 中 我 们 都 会 用 到 该 界面 来 编辑 文本 ， 
这 两 个 功能 的 具体 实现 请 分 别 参考 7.9.3 节 和 7.10.3 节 的 相关 内 容 。 


代码 清单 7-31 


<manifest http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
«application http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
«activity android:name=".app.AppEditText" ui 
android:theme-"(style/com.app.demos.theme.light" 
android:windowSoftInputMode-"stateVisible|adjustResize" 
android: launchMode="singleTop"> 
<intent-filter> 
<action android:name-"com.app.demos.EDITTEXT" /> 
<action android:name="android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 
</activity> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</application> m 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
</manifest> 


另外 ， 大 家 可 以 发 现 doEditText 方 法 在 开启 新 的 Activity 的 同时 并 没有 像 forward 方 法 一 样 ， 即 关闭 当前 的 界面 。 因 此 ， 被 打开 的 新 界面 会 覆盖 在 原先 界面 之 上 ， 也 就 是 说 新 界面 的 Activity 会 被 加 入 到 
应 用 的 Activity 内 存 扒 栈 中 去 ， 我 们 在 使 用 该 方法 的 时 候 ， 既 要 注意 这 种 行为 模式 的 特点 ， 也 需要 多 关注 一 下 内 存 的 使 用 状况 。 


m 


73 ”网 络 通信 模块 


随 着 3G 时 代 的 来 临 ，Android 应 用 与 移动 互联 网 的 结合 愈加 紧密 ;因此 ， 对 于 移动 互联 网 应 用 来 说 ， 网 络 通信 无 疑 是 必 备 的 核心 模块 之 一 。 移 动 互联 网 的 用 途 很 多 ， 获 取 新 闻 、 聊 天 对 话 、 在 线 购物 、 
移动 定位 等 都 给 我 们 带 来 强大 的 功能 和 美妙 的 体验 。 微 博 应 用 就 是 移动 互联 网 应 用 的 典型 代表 ， 也 是 目前 最 流行 的 移动 互联 网 应 用 之 一 ; 所以， 网 络 通信 模块 对 于 微 博 应 用 来 说 也 是 必 不 可 少 的 。 


Android 应 用 框架 为 我 们 提供 了 强大 的 网 络 功能 。 首 先是 Android 系 统 框架 底层 网 络 功能 的 支持 ， 由 于 Android 系 统 是 基于 Linux 内 核 的 ， 也 继承 了 Linux 系 统 强大 的 网 络 功能 ， 这 部 分 功能 在 进行 系统 底 
屋 开 发 的 时 候 会 使 用 到 ， 限 于 篇 幅 ， 本 书 暂 不 讨论 。 然 后 是 Android 应 用 框架 的 Chrome 浏 览 器 ， 良 好 的 兼容 性 和 快速 的 运行 速度 可 以 完美 地 支持 Web 相 关 的 功能 ， 这 部 分 内 容 详 见 7.11 节 内 容 。 接 着 是 
ava 语 言 为 我 们 准备 的 网 络 相关 类 ， 即 java.net.* 类 包 下 的 标准 Java 接口 ， 包 括 Socket 套 接 字 、TCP/IP 网 络 协议 以 及 HTTP 网 络 协议 处 理 的 内 容 ， 与 此 相当 的 还 有 android.net.* 类 包 下 接口 以 及 Apache 组 织 
提供 的 HttpClient 接 口 。 另 外 ， 根 据 本 书 微 博 实例 的 特点 ， 本 节 将 重点 介绍 基于 HTTP 协 议 的 网 络 通信 。 


小 贴 士 : Chrome 浏 览 器 ， 又 称 Google 浏 览 器 ， 是 一 个 由 Google (谷歌 ) 公司 开发 的 开放 原始 码 网 页 浏览 器 。 该 浏览 器 基于 WebKit 浏 览 器 内 核 来 开发 的 ， 特 点 是 具有 较 好 稳定 性 和 安全 性 ， 以 及 快速 的 
avaScfipt 执 行 速度 ， 而 Android 系 统 使 用 的 是 Chrome Lite， 即 移动 简化 版 Chrome 浏 览 器 ， 此 浏览 器 具有 强大 的 扩展 性 并 且 可 以 谋 入 到 Android 应 用 中 去 ， 这 部 分 内 容 我 们 会 在 7.11 节 中 给 大 家 做 详细 介绍 。 


7.3.1 使 用 HttpClient 进 行 网 络 通信 


众所周知 ，HTTP 协 议 可 以 算是 互联 网 领域 中 使 用 最 为 广泛 的 网 络 协议 了 ， 而 微 博 应 用 也 是 使 用 HTTP 协 议 来 进行 通信 的 。 考 虑 到 方便 性 、 稳 定性 等 方面 的 因素 ， 我 们 决定 以 Apache 提 供 的 HttpClient 为 
基础 ， 并 对 该 类 进行 合理 的 包装 ， 进 而 形成 微 博 应 用 的 网 络 通信 类 AppClient， 该 类 归属 于 工具 类 包 com.app.demos.util 之 下 ， 完 整 代码 见 代码 清单 7-32。 另 外 ， 网 络 通 信 这 部 分 的 内 容 和 服务 端 接口 有 较 
大 的 关系 ， 在 阅读 的 同时 可 结合 第 6 章 中 与 微 博 服务 端 API 接 口 相关 的 内 容 来 理解 。 


代码 清单 7-32 


package com.app.demos.util; 
import java.io.IOException; 
import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Iterator; 
import java.util.List; 
import java.util.Map; 
import org.apache.http.HttpEntity; 
import org.apache.http.HttpHost; 
import org.apache.http.HttpResponse; 
import org.apache.http.HttpStatus; 
import org.apache.http.NameValuePair; 
import org.apache.http.client.HttpClient; 
import org.apache.http.client.entity.UrlEncodedFormEntity; 
import org.apache.http.client.methods.HttpGet; 
import org.apache.http.client.methods.HttpPost; 
import org.apache.http.conn.ConnectTimeoutException; 
import org.apache.http.conn.params.ConnRoutePNames; 
import org.apache.http.impl.client.DefaultHttpClient; 
import org.apache.http.message.BasicNameValuePair; 
import org.apache.http.params.BasicHttpParams; 
import org.apache.http.params.HttpConnectionParams; 
import org.apache.http.params.HttpParams; 
import org.apache.http.protocol.HTTP; 
import org.apache.http.util.EntityUtils; 
import com.app.demos.base.C; 
import android.util.Log; 
GSuppressWarnings ("rawtypes") 
public class AppClient ( 

// 压缩 配置 


final Private static int CS_NONE 

final private static int CS GZIP 

// 必要 类 属性 

private String apiUrl; 

private HttpParams httpParams; 

private HttpClient httpClient; 

private int timeoutConnection = 10000; 

private int timeoutSocket = 10000; 

private int compress = CS NONE; 

// 黑 认 字符 集 为 DTF8 

private String charset = HTTP.UTF 8; 

public AppClient (String url) { 7 
initClient (url); 


|o 


} 
public AppClient (String url, String charset, int compress) { 
initClient (url); 
this.charset = charset; 
this.compress = compress; 
} 
private void initClient (String url) { 
// 初始 化 API 的 URL 地 址 ， 自 动 添加 Session ID 
this.apiUrl = C.api.base + url; 
String apiSid = AppUtil.getSessionId(); 
if (apiSid != null && apiSid.length() > 0) { 
this.apiUrl += "?sid=" + apiSid; 


l 

// 设置 网 络 超时 

httpParams = new BasicHttpParams(); 
HttpConnectionParams.setConnectionTimeout (httpParams, timeoutConnection); 
HttpConnectionParams.setSoTimeout (httpParams, timeoutSocket); 

// 初始 化 HttpClient 对 象 

httpClient = new DefaultHttpClient (httpParams) ; 


} 
public void useWap () { 
// 与 支持 WAP 上 网 方式 有 关 的 逻辑 
HttpHost proxy = new HttpHost("10.0.0.172", 80, "http"); 
httpClient.getParams ().setParameter (ConnRoutePNames.DEFAULT PROXY, proxy); 
š 
public String get () throws Exception { 
try { 
// 初始 化 GET 请 求 对 象 
HttpGet httpGet = headerFilter (new HttpGet (this.apiUrl)); 
// 记录 GET 请 求 发 送 日 志 
Log.w("AppClient.get.url", this.apiUrl); 
// 发 送 GET 请 求 
HttpResponse httpResponse = httpClient.execute (httpGet) ; 
if (httpResponse.getStatusLine() .getStatusCode() == HttpStatus.SC OK) ( 
String httpResult = resultFilter (httpResponse.getEntity ()); 
Log.w("AppClient.get.result", httpResult); 
return httpResult; 
) else ( 
return null; 
} 
} catch (ConnectTimeoutException e) { 
throw new Exception(C.err.network); 
} catch (Exception e) { 
e.printStackTrace () ; 


return null; 
f 
public String post (HashMap urlParams) throws Exception { 
try { 
// 初始 化 POST 请 求 对 象 
HttpPost httpPost = headerFilter (new HttpPost (this.apiUrl)); 
List<NameValuePair> postParams = new ArrayList<NameValuePair>(); 
// 构造 POST 请 求 参数 
Iterator it = urlParams.entrySet ().iterator(); 
while (it.hasNext()) { 
Map.Entry entry = (Map.Entry) it.next(); 
postParams.add(new BasicNameValuePair (entry.getKey() .toString(), 
entry.getValue() .toString())); 


} 
// 设置 POST 请 求 参数 编码 
if (this.charset != null) { 
httpPost.setEntity (new UrlEncodedFormEntity (postParams, this.charset)); 
) else ( 
httpPost.setEntity (new UrlEncodedFormEntity (postParams)); 


} 
// 记录 POST 请 求 发 送 日 志 
Log.w("AppClient.post.url", this.apiUrl); 
Log.w("AppClient.post.data", postParams.toString()); 
// 发 送 POST 请 求 
HttpResponse httpResponse = httpClient.execute (httpPost) ; 
if (httpResponse.getStatusLine () .getStatusCode () == HttpStatus.SC OK) { 
String httpResult = resultFilter(httpResponse.getEntity()); 
// 记录 POST 请 求 结果 日 志 
Log.w("AppClient.post.result", httpResult); 
return httpResult; 
} else { 
return null; 
} 
} catch (ConnectTimeoutException e) { 
throw new Exception (C.err.network) ; 
} catch (Exception e) { 
e.printStackTrace(); 
} 
return null; 
} 
private HttpGet headerFilter (HttpGet httpGet) { 
// 为 GET 请 求 对 象 设置 请 求 头 
switch (this.compress) { 
case CS GZIP: 
httpGet.addHeader ("Accept-Encoding", "gzip"); 
break; 
default : 
break; 


return httpGet; 
} 
private HttpPost headerFilter (HttpPost httpPost) { 
// 为 POST 请 求 对 象 设置 请 求 头 
Switch (this.compress) { 
case CS GZIP: 
httpPost.addHeader ("Accept-Encoding", "gzip"); 
break; 
default : 
break; 


return httpPost; 

} 

private String resultFilter (HttpEntity entity) { 
String result = null; 


y í 
// 对 请 求 结果 进行 GZIP 解 码 处 理 
switch (this.compress) { 
case CS GZIP: 
result = AppUtil.gzipToString (entity); 
break; 
default : 
result = EntityUtils.toString (entity); 
break; 


$ 
} catch (IOException e) { 
e.printStackTrace () ; 
} 


return result; 


AppClient 类 的 


1. 类 声明 


代码 


比较 长 ， 涉 及 的 知识 点 也 比较 多 ， 为 了 便于 大 家 理解 ， 我 们 会 按照 由 上 至 下 的 阅读 顺序 ， 把 该 类 中 比较 重要 的 知识 点 逐个 剖析 并 归纳 如 下 。 


首先 ， 我 们 看 包 引 


， 除 了 内 java 开 头 的 Java 原 生 类 包 之 外 ， 大 部 分 的 类 包 都 是 以 org.apache.http 开 头 的 HttpClient 的 类 库 ， 这 点 很 容易 理解 。 然 后 是 类 名 ，AppClient 不 继承 任何 基 类 ， 此 类 中 所 有 


HttpClient 的 使 用 都 是 直接 初始 化 使 用 的 ， 这 个 特点 和 HttpClient 的 使 用 方式 有 较 大 的 关系 。 


2. 构 造 方法 


AppClient 类 有 两 个 构造 方法 ,我 们 经 常 使 用 前 者 ， 即 只 包含 唯一 参数 的 构造 方法 ， 而 这 唯一 的 参数 url 实 际 上 就 是 服务 端 API 接 口 的 网 络 地 址 ， 也 是 每 个 网 络 请 求 所 必须 具备 的 重要 参数 ， 在 这 种 情况 下 


的 网 络 通信 使 用 默认 模式 ， 即 使 


UTF-8 编 码 和 非 压缩 的 传输 模式 。 当 然 ， 如 果 需 要 修改 这 些 配置 则 需要 使 用 另 一 个 构造 方法 ， 该 方法 除了 接口 地 址 url 之 外 ， 还 有 数据 编码 charset 和 压缩 模式 compress 两 


个 参数 ， 这 样 使 用 的 时 候 就 可 以 根据 实际 情况 来 选择 网 络 通信 的 传输 模式 。 


3.initClient 方 法 


AppClient 类 中 重要 属性 ， 即 httpClient 对 象 属性 的 初始 化 方法 。 逻 辑 包括 初始 化 API 基 础 地 址 (在 C.api.base 中 定义 ) 、 设 置 网 络 超时 (使 用 BasicHttpParams 类 ) 以 及 为 API 请 求 自动 添加 Session 
1D， 即 通过 工具 类 AppUtil 中 的 getSessionld 方 法 获取 。 


4.useWap 方 法 


此 方法 主要 用 于 支持 使 


们 将 在 7.3.2 节 中 做 详细 介绍 。 


5.get 方 法 


CMWAP 网 络 接 入 方式 的 用 户 上 网 ， 该 方法 逻辑 比较 简单 ， 就 是 为 httpClient 对 象 设置 一 个 代理 地 址 ， 而 它 被 调用 的 时 候 ， 设 备 就 可 以 通过 CMWAP 上 网 了 ， 更 多 相关 知识 我 


此 方法 用 于 处 理 HTTP 协 议 的 GET 请 求 。 在 GET 方 式 中 ， 所 有 GET 参 数 都 是 直接 存放 在 URL 地 址 中 的 ， 所 以 AppClient 的 get 方 法 没有 设置 参数 ， 用 户 通 过 构造 方法 成 功 初始 化 好 API 的 URL 地 址 之 后 ， 就 
可 直接 使 用 该 方法 来 发 送 请 求 并 获取 结果 数据 。 方 法 逻辑 并 不 复杂 ， 先 构造 HttpGet 对 象 ， 然 后 使 用 httpClient 对 象 的 execute 方 法 来 发 送 请 求 并 获取 HttpResponse 返 回 对 象 ， 最 后 使 用 resultFilter 方 法 来 


处 理 返 回 的 结果 。 


6.post 方 法 


此 方法 用 于 处 理 HTTP 协 议 POST 请 求 。 在 POST 方式 中 ， 所 有 POST 参数 都 被 重新 组 装 并 存放 在 HTTP 请 求 头 中 ， 所 以 AppClient 的 post 方 法 需要 传 入 包含 请 求 参数 和 参数 值 的 键 值 对 (key-value) 型 数 


据 ， 为 了 方便 我 们 使 


HashMap 来 存储 这 些 数据 。 该 方法 的 逻辑 比 get 方 法 略 复杂 一 些 ， 除 了 构造 HttpPost 对 象 和 获取 HttpResponse 对 象 的 标准 逻辑 之 外 ， 还 增加 了 把 包含 POST 请 求 的 HashMap 数 据 转 


化 成 符合 HttpClient 要 求 的 NameValuePair 型 数据 的 逻辑 ， 以 及 对 POST 请 求 数据 进行 必要 编码 的 逻辑 ， 最 后 同样 使 用 resultFilter 方 法 来 处 理 返回 的 结果 。 


7.headerFilter#l 


OresultFilter 方 法 


两 个 方法 分 别 


缩 方式 来 传输 数据 。 


往 这 两 个 方法 中 添加 


了 解 了 AppClient 类 的 了 


内 容 ; 二 是 即时 通知 


于 HTTP 请 求 头 的 设置 以 及 HTTP 请 求 结 果 的 处 理 。headerFilter 有 两 个 方法 ， 分 别 用 于 设置 GET 和 POST 的 请 求 头 ， 这 里 我 们 可 以 通过 该 方法 来 设置 gzip 请 求 头 ， 通 知 服务 器 使 用 gzip 压 


更 多 逻辑 来 扩 ; 


resultFilter 方 法 则 可 用 于 处 理 请 求 的 结果 ， 这 里 可 以 对 压缩 传输 过 来 的 数据 进行 解压 处 理 。 这 部 分 内 容 与 优化 数据 传输 的 功能 有 关 ， 更 多 相关 知识 可 以 参考 9.2.2 节 。 此 外 ， 我 们 还 可 以 


展 AppClient 的 功能 。 


要 逻辑 ， 接 下 来 学 习 该 类 的 使 用 方法 。 在 微 博 应 用 客户 端 中 ，AppClient 主 要 用 在 两 个 地 方 ， 一 是 异步 任务 模块 中 的 网 络 请 求 逻 辑 ， 该 模块 的 详细 内 容 请 参考 本 章 7.4 节 的 相关 


代码 清单 7-33 


功能 中 的 网 络 请 求 逻辑 ， 这 部 分 代码 位 于 基础 类 库 com.app.demos.base 中 的 BaseService.java 文 件 中 ， 可 参考 代码 清单 7-33。 


public class BaseService extends Service { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void doTaskAsync (final int taskId, final String taskUrl, final 
HashMap<String, String> taskArgs) { 
// 获取 保存 在 SharedPreferences 中 的 HTTP 网 络 连接 类 型 
SharedPreferences sp = AppUtil.getSharedPreferences (this); 
final int httpType = sp.getInt(HTTP TYPE, 0); 
ExecutorService es = Executors.newSingleThreadExecutor () ; 
es .execute (new Runnable () { 
GOverride 
public void run() ( 
try { 


// 初始 化 AppClient 对 象 
AppClient client = new AppClient (taskUrl); 
// 判断 是 否 支持 CMWAP 模 式 
if (httpType == HttpUtil.WAP INT) { 
client.useWap(); 
} 
String httpResult = client.post (taskArgs) ; 
// 将 结果 传 入 onTaskCormplete 方 法 中 处 理 
onTaskComplete (taskId, AppUtil.getMessage (httpResult)); 


} catch (Exception e) ( 


} 
} 


n; 


e.printStackTrace(); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


BaseService 类 是 微 博 通知 服务 类 NoticeService 的 基 类 ， 类 中 的 异步 任务 方法 doTaskAsync 用 于 从 服务 端 获取 通知 信息 ;不 过 此 方法 和 界面 控制 器 基 类 BaseUi 中 的 doTaskAsync 方 法 不 同 ，BaseUi 中 的 
是 基于 基础 任务 池 类 BaseTaskPool 的 ， 而 这 里 的 doTaskAsyn<c 方 法 则 使 用 更 简单 的 单线 程 池 ， 在 线程 接口 的 run 方 法 中 我 们 就 可 以 看 到 AppClient 的 使 用 代码 示例 。 接 着 我 们 便 来 分 析 此 处 AppClient 网 络 通 


信 类 的 使 用 方法 。 


首先 


初始 化 AppClient 对 象 ， 设 置 请 求 API 接 口 的 URL 地 址 ; 然后 ， 使 用 HttpUtil 工 具 类 判断 是 否 应 该 采用 CMWAP 网 络 接 入 方式 ， 是 则 调用 useWap 方 法 ，HttpUtil 的 使 用 方法 将 在 7.3.2 节 中 介绍 ; 


最 后 ， 使 用 post 方 法 发 送 请 求 至 | 


有 务 端 并 获取 返回 信息 ， 然 后 传 入 onTaskComplete 方 法 进行 处 理 ， 当 然 ，onTaskComplete 方 法 将 在 Baseservice 的 子 类 ， 比 如 微 博 通知 服务 类 NoticeService 中 被 加 入 处 


理 网 络 返 回信 息 的 逻辑 。 这 里 还 用 到 了 应 用 工具 类 AppUtil 中 的 getMessage 来 处 理 JSON 消 息 的 内 容 ， 这 点 可 参考 7.3.3 节 中 内 容 。 


7.3.2 ”支持 CMWAP 网 络 接 入 方式 


CMWAP 和 CMNET 只 是 中 国 移动 人 为 划分 的 两 个 GPRSs 接 入 方式 。 前 者 是 为 手机 WAP 上 网 而 设立 的 ， 后 者 则 主要 是 为 PC、 笔 记 本 电脑 、PDA 等 利用 GPRS 上 网 服务 。 前 面 通过 对 微 博 客户 端 框架 的 网 络 
通信 类 AppClient 的 介绍 ， 使 我 们 了 解 到 CMWAP 的 基本 使 用 方式 ，useWap 就 是 打开 CMWAP 模 式 的 开关 方法 ; 不 过 在 BaseSerive 类 中 对 使 用 实例 代码 的 介绍 中 ， 我 们 引出 了 另外 一 个 问题 ， 那 就 是 如 何 知 


道 设备 是 否 应 该 使 


CMWAP 模 式 ， 


因为 只 有 在 确定 设备 处 于 CMWAP 上 网 模式 的 情况 下 ， 我 们 才 可 以 打开 CMWAP 模 式 的 开关 ， 否 则 反而 可 能 导致 设备 无 法 上 网 。 而 获取 设备 上 网 模式 的 关键 功能 则 是 使 


HttpUtil 工 具 类 来 实现 的 ， 此 类 的 完整 代码 如 代码 清单 7-34 所 示 。 


代码 清单 7-34 


package com. 


app.demos.util; 


import android.content.Context; 

import android.database.Cursor; 

import android.net.ConnectivityManager; 
import android.net.NetworkInfo; 

import android.net.Uri; 

public class HttpUtil { 


static public int WAP INT 
static public int NET INT 


1; 
25 


static public int WIFI INT - 3; 

static public int NONET INT - 4; 

static private Uri APN URI - null; 

static public int getNetType (Context ctx) { 


// 判断 是 否 有 网 络 
ConnectivityManager conn = null; 
try ( 


conn = (ConnectivityManager) ctx.getSystemService (Context .CONNECTIVITY_SERVICE) ; 


} catch (Exception e) { 
e.printStackTrace () ; 
} 
if (conn == null) { 
return HttpUtil.NONET_INT; 
} 
NetworkInfo info = conn.getActiveNetworkInfo(); 
boolean available = info.isAvailable(); 
if (!available) { 
return HttpUtil.NONET_INT; 


l 

// 判断 是 否 使 用 TFI 模式 

String type = info.getTypeName () ; 

if (type.equals("WIFI")) { 
return HttpUtil.WIFI INT; 


} 
// 判断 是 否 使 用 CMWRP 模 式 


APN URI = Uri.parse("content://telephony/carriers/preferapn"); 
Cursor uriCursor = ctx.getContentResolver().query(APN URI, null, null, null, null); 


if (uriCursor !- null && uriCursor.moveToFirst()) 


String proxy - uriCursor.getString (uriCursor.getColumnIndex ("proxy")); 
String port = uriCursor.getString (uriCursor.getColumnIndex ("port")); 
String apn = uriCursor.getString (uriCursor.getColumnIndex ("apn")); 

if (proxy != null && port !- null && apn !- null && apn. 


equals ("cmwap") && port.equals("80") && 


(proxy.equals ("10.0.0.172") || proxy.equals ("010.000.000.172"))) { 


return HttpUtil.WAP INT; 
} 
} 
return HttpUtil.NET_INT; 


观察 HttpUtil 的 代码 结构 ， 我 们 可 以 得 到 整体 的 认识 。 首 先 ， 该 类 位 于 微 博 应 用 项 目的 工 


性 分 别 代表 着 4 种 最 


1. 使 用 上 下 文 (Context) 


getNetType 只 有 一 个 参数 ， 即 Activity Context， 也 就 是 界面 上 下 文 对 象 (参考 2.5.1 节 相关 内 容 ) ， 这 里 的 上 下 文通 常会 是 应 用 上 下 文 ， 也 就 是 Application Context。 在 程序 中 我 们 不 仅 使 用 应 用 上 


下 文 对 象 的 getSystemService 方 法 来 获取 网 络 系统 服务 (CONNECTIVITY SERVICE) 对 象 ， 还 使 用 上 下 文 对象 的 getContentResolver 方 法 来 获取 系统 的 ContentResolver 对 象 ， 进 而 查询 Android 系 统 的 


相关 参数 。 


2. 未 联网 模式 


判断 设备 是 否 联网 需要 用 到 ConnectivityManager 类 ， 此 类 用 于 获取 设备 的 网 络 状态 ， 程 序 使 
该 设备 未 联网 。 当 然 ，ConnectivityManager 还 : 


模式 ， 使 用 方法 如 代码 清单 7-35 所 示 。 


代码 清单 7- 


35 


类 包 com.app.demos.util 之 中 ， 类 名 HttpUtil 表 示 该 类 是 Http 网 络 通信 的 工具 类 ; 其 次 ，4 个 静态 的 public 属 
主要 的 上 网 模式 ， 分 别 是 CMWAP 模 式 WAP_INT、CMNET 模 式 NET_INT、WIFI 模 式 WIFLINT 以 及 非 联网 模式 NONET_INT; 然后 ， 该 类 目前 只 有 一 个 方法 getNetType， 也 就 是 用 于 获 


getActiveNetworklnfo 方 法 获取 活动 的 网 络 状态 并 保存 在 Networklnfo 对 象 中 ， 如 果 获 取 失 败 则 认为 
还 提供 了 getNetworklnfo 方 法 来 获取 网 络 设备 的 状态 ， 包 括 蓝牙 (TYPE BLUETOOTH) 、 手 机 网 络 (TYPE MOBILE) 以 及 WIFI 网 络 (TYPE WIFI) 等 联网 


ConnectivityManager conn = (ConnectivityManager) getSystemService (Context.CONNECTIVITY SERVICE); 
State wifi = conn.getNetworkInfo (ConnectivityManager.TYPE_WIFI) .getState(); 


3.WIFI 模 式 


在 使 用 getActiveNetworklnfo 方 法 获取 到 活动 的 网 络 状态 之 后 ， 程 序 使 有 


4.CMWAP 模 式 


该 模式 的 获取 方法 和 WIFI 模式 的 不 大 一 样 ， 准 确 来 说 CMWAP 应 该 是 


Content Resolver 的 查询 功能 去 系统 的 Content Provider 接 


代码 。 


getTypeName 来 获取 活动 网 络 的 名 称 ， 如 果 能 


nWIFI 匹 配 ， 我 们 则 认为 设备 正在 使 用 WIFI 联网 模式 。 


手机 联网 模式 (TYPE MOBILE) 中 的 一 种 ，ConnectivityManager 无 法 获取 到 该 模式 的 任何 状态 ， 我 们 需要 借助 内 容 处 理 器 
查询 相关 信息 ， 有 关内 容 我 们 曾经 在 2.4.4 节 中 简单 介绍 过 ， 而 方法 中 获取 CMWAP 模 式 的 相关 逻辑 正好 可 作为 ContentResolver 类 使 用 的 示例 


首先 ， 使 用 Uri 类 的 parse 方 法 初始 化 设备 APN 设 置 的 Uri 对 象 ， 该 资源 的 对 应 URI 是 “content: //telephony/carriers/preferapn" ， 对 应 的 内 容 就 是 系统 设置 菜单 中 网 络 设置 的 APN 相 关 设 置 ; 然后 ， 


使 用 ContentResolver 的 查询 接口 query 来 获取 指针 变量 uriCursor; 最 后 通过 循环 获取 APN 设 置 中 的 代理 地 址 、 端 口 
门 则 认为 设备 正 处 于 CMWAP 联 网 模式 中 。 


准 代理 地 址 。 如 果 判 断 相 符 ,我 


= 


判断 完毕 之 后 ， 如 果 需 要 使 用 CMWAP 联 网 模式 ， 我 们 只 要 使 用 AppClient 类 的 useWap 方 法 即 可 ， 该 方法 的 使 有 
式 上 网 的 用 户 群 正在 逐渐 缩小 ， 但 是 对 CMWAP 的 支持 肯定 是 一 个 


等 信息 来 判断 是 否 符合 CMWAP 的 设置 ， 其 中 “10.0.0.172” 代 表 的 就 是 CMWAP 的 标 


733 ”使 用 JSON 库 为 消息 解码 


比较 完善 的 移动 互联 网 应 用 不 得 不 考虑 的 问题 。 


微 博 应 用 服务 端 和 客户 端 之 间 的 消息 交互 使 用 的 是 JSON 协 议 ， 因 此 当 客 户 端 获取 到 对 应 服务 端 接口 的 返回 数据 之 后 ， 


1JSONObject 


应 用 框架 为 我 们 提供 了 强大 的 JSON 库 ， 位 于 orgjson 类 包 之 下 ， 主 要 包括 以 下 两 个 JSON 解 析 类 。 


方式 很 简单 ， 有 具体 示例 可 参考 代码 清单 7-33。 虽 然 随 着 移动 网 络 的 发 展 ， 以 CMWAP 方 


需要 把 JSON 格 式 的 数据 转化 成 模型 对 象 才能 被 Android 系 统 所 使 用 。Android 


2.JSONArray 


于 把 对 象 型 的 JSON 数 据 转 化 成 JSONObject 对 象 ， 然 后 使 用 get 系 列 方法 获取 对 象 属性 的 数据 。 其 中 最 常用 的 方法 为 getString， 即 获取 数据 并 存 为 字符 串 ， 这 样 处 理 也 是 为 了 适应 Web 应 用 的 特点 。 
除 此 之 外 ， 还 有 两 个 方法 需要 我 们 注意 ， 即 getJSONArray 和 getJSONObject 方 法 ,它们 


的 存在 是 为 了 处 理 复合 型 的 JSON 数 据 ， 分 别 用 于 获取 数组 型 和 对 象 型 的 属性 值 。 


于 把 数组 型 的 JSON 数 据 转 化 成 JJONArray 对 象 ， 该 类 所 提供 方法 和 JSONObject 类 基本 相同 ， 只 不 过 : 


中 的 get 系 列 方法 的 参数 都 是 整 型 (int) ， 代 表 的 是 数组 型 数据 的 位 置 索 引 。 


另外 ， 以 上 两 个 JSON 解 析 类 均 提 供 了 tostring 方 法 ， 用 于 快速 地 把 对 象 转化 成 字符 串 ， 该 方法 经 常 在 调试 的 时 候 使 用 ， 更 多 用 法 请 参考 SDK 文 档 中 org,json 包 的 内 容 。 


对 于 微 博 应 用 来 说， 不 同 API 接 口 所 返 | 


使 用 到 了 。 


回 


的 数据 格式 都 是 不 一 样 的， 但 是 都 要 符合 一 定 的 协议 规范 ， 否 则 将 大 大 增加 解析 膛 辑 的 复杂 度 。 这 样 ， 我 们 之 前 在 4.6 节 中 所 制定 的 消息 协议 的 规范 ， 这 里 就 要 


在 实际 项 目 中 ， 仅 仅 把 JSON 数 据 解析 出 来 还 是 不 够 的 ， 因 为 通常 在 客户 端 程序 中 用 于 数据 处 理 的 是 模型 对 象 【Model) ， 因 此 我 们 还 需要 把 JSON 数 据 转化 为 对 应 的 模型 对 象 ， 在 协议 中 我 们 使 用 “ 模 


型 名 ”和 “模型 名 .list” 的 键 值 来 表示 模型 对 象 和 模型 对 象 数组 。 这 个 ; 


Eí 


中 的 getMessage 方 法 ， 如 代码 清单 7-36 所 示 。 


代码 清单 7-36 


public class AppUtil ( 


程 比较 复杂 ， 不 过 幸运 的 是 微 博 客户 端 程序 框架 已 经 为 我 们 提供 了 非常 方便 的 方法 来 完成 这 个 转化 ， 此 方法 就 是 应 用 工具 类 AppUtil 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


static public Bas 
BaseMessage 
JSONObject 
try ( 


eMessage getMessage (String jsonStr) throws Exception ( 
message = new BaseMessage(); 
jsonObject = null; 


jsonObject = new JSONObject (jsonStr); 


if Gj 


š 
) catch (JS 


sonObject != null) ( 
message.setCode (jsonObject .getString ("code") ); 
message.setMessage (jsonObject.getString ("message")); 
message.setResult (jsonObject.getString ("result") ); 


ONException e) { 


throw new Exception("Json format error"); 


} catch (Ex 
e.pri 
} 


return mess. 


} 


ception e) { 
ntStackTrace () ; 


age; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


AppUtil 类 中 的 getMessage 方 法 是 静态 的 ， 


作用 是 把 JSON 消 息 转化 成 基础 消息 对 象 ， 即 BaseMessage 类 对 象 ; 此 方法 在 前 面 介 绍 网 络 通信 类 AppClient 的 时 候 就 遇 到 过 ， 使 用 范例 可 参考 代码 清单 


7-33。getMessage 方 法 的 逻辑 不 是 很 复杂 ， 按 照 JSON 协 议 的 定义 ， 消 息 最 外 层 使 用 的 是 对 象 结构 的 数 
result， 接 着 再 传 入 新 建 的 BaseMessage 对 象 中 去 。 当 然 ， 如 果 解 析 失 败 ， 则 会 抛 出 异常 信息 “Json format error" , 


接 下 来 ， 我 们 来 重点 分 析 


在 。BaseMessage 类 位 于 应 


代码 清单 7-37 


居 ， 所 以 这 里 使 用 JSONObject 来 解析 ， 返 回信 息 包括 代码 号 code、 提 示 信息 message 和 数据 集合 


基础 消息 类 BaseMessage 的 逻辑 ， 因 为 该 类 中 包含 了 对 JSON 消 息 中 的 数据 集合 字段 “result” 的 处 理 逻 辑 ， 而 这 正 是 JSON 消 息 数据 如 何 转 化 成 模型 对 象 的 “核心 机 密 ” 所 


基础 类 包 com.app.demos.base 中 的 BaseMessage.java 文 件 中 ， 完 整 类 代码 如 代码 清单 7-37 所 示 。 


package com.app.demos .b 
import java.lang.reflec 
import java.util.ArrayL. 
import java.util.HashMa] 
import java.util.Iterat 
import java.util.Map; 

import org.json.JSONArr. 
import org.json.JSONObj 
import com.app.demos.ut 


ase; 
t.Field; 
ist; 

p; 

or; 


ay; 
ect; 
il.AppUtil; 


public class BaseMessage ( 


private String co 
private String me: 
private String re: 
private Map<Strin 
private Map<Strin: 


de; 

ssage; 

sultSrc; 

g, BaseModel» resultMap; 

g, ArrayList<? extends BaseModel>> resultList; 


public BaseMessage () { 
this.resultMap = new HashMap<String, BaseModel>(); 
this.resultList = new HashMap<String, ArrayList<? extends BaseModel»»(); 


J 

GOverride 

public String toS 
return code 


} 


tring () { 
+" | " + message +" | " + resultSrc; 


public String getCode () { 


return this 


} 


-code; 


public void setCode (String code) ( 


this.code = 


code; 


f 
public String getMessage () { 


return this 


} 
public void setMe 


message; 


ssage (String message) ( 


this.message = message; 


) 


public String getResult () { 


return this 


} 


.resultSrc; 


public Object getResult (String modelName) throws Exception { 


Object mode 


l = this.resultMap.get (modelName) ; 


// 返回 空 模型 异常 
if (model == null) { 


throw 


} 


return mode 


} 


new Exception ("Message data is empty"); 


l; 


public ArrayList<? extends BaseModel> getResultList (String modelName) throws Exception { 


ArrayList<? extends BaseModel> modelList = this.resultList.get (modelName) ; 
// 返回 空 数据 异常 
if (modelList == null || modellist.size() == 0) { 

throw new Exception ("Message data list is empty"); 


} 

return mode 
r 
GSuppressWarnings 
public void setRe: 

this.result 

if (result. 


lList; 


("unchecked") 

sult (String result) throws Exception ( 
Src - result; 

length() » 0) ( 


JSONObject jsonObject = null; 
jsonObject = new JSONObject (result); 


Itera 
while 


tor<String> it = jsonObject.keys(); 

(it.hasNext()) ( 

// 获取 模型 名 、 类 名 以 及 模型 数据 

String jsonKey = it.next(); 

String modelName = getModelName (jsonKey) ; 

String modelClassName = "com.app.demos.model." + modelName; 
JSONArray modelJsonArray = jsonObject.optJSONArray (jsonKey) ; 


} 
} 
GSuppressWa: 
private Bas 


// 模型 数据 为 对 象 (JSONObject) 的 情况 
if (modelJsonArray == null) { 
JSONObject modelJsonObject = jsonObject.optJSONObject (jsonKey) ; 
if (modelJsonObject == null) { 
throw new Exception("Message result is invalid"); 
} 
this.resultMap.put (modelName, json2model (modelClassName, 
modelJsonObject)); 
// 模型 数据 为 数组 (JSONArray) 的 情况 
) else ( 
ArrayList<BaseModel> modelList = new ArrayList<BaseModel>(); 
for (int i = 0; i < modelJsonArray.length(); i++) { 
JSONObject modelJsonObject = modelJsonArray.optJSONObject (i); 
modelList.add(json2model (modelClassName, modelJsonObject)); 
} 
this.resultList.put (modelName, modelList) ; 


} 


rnings ("unchecked") 
eModel json2model (String modelClassName, JSONObject 


modelJsonObject) throws Exception { 
// 利用 Java 反 射 自 动 加 载 模型 类 
BaseModel modelObj = (BaseModel) Class.forName (modelClassName) .newInstance(); 
Class<? extends BaseModel» modelClass = modelObj.getClass(); 


// 利用 Java 反 射 自动 加 载 模型 属性 


Itera 
while 


} 
retur 
š 
private Str. 
Strin 
if (s 


} 


retur 


tor<String> it = modelJsonObject.keys(); 

(it.hasNext()) { 

String varField = it.next(); 

String varValue = modelJsonObject.getString (varField) ; 
Field field = modelClass.getDeclaredField (varField) ; 
field.setAccessible (true); // have private to be accessable 
field.set (modelObj, varValue); 


n modelObj; 

ing getModelName (String str) ( 
g[] strArr = str.split("NW"); 
trArr.length > 0) ( 

str = strArr[0]; 


n AppUtil.ucfirst (str); 


消息 基础 类 BaseMessage 是 服务 端 和 客户 端 之 间 进 行 数 据 传输 的 桥梁 ， 是 微 博 应 用 框架 的 基础 核心 类 库 ， 不 过 该 类 的 代码 比较 多 ， 逻 辑 也 相对 比较 复杂 。 因 此 ， 下 面 我们 将 从 多 个 方面 对 该 类 的 要 点 做 


细致 的 分 析 。 
(1) 数据 结构 


BaseMessage 类 是 
resultList 两 个 Map 型 的 
模型 类 的 名 称 。 


(2) get/set 方 法 


BaseMessage 类 中 


按照 JSJON 协 议 的 格式 来 设计 的 。 首 先 ，code、message 和 resultSrc 三 个 String 型 的 类 属性 分 别 对 应 了 JsON 消 息 协议 中 的 code、message 和 result 三 个 键 名 ; 其 次 ，resultMap 和 
类 属性 则 分 别 用 于 存储 单个 模型 对 象 和 模型 对 象 数组 的 数据 ; 另外 ， 按 照 之 前 微 博 应 用 通信 协议 的 设计 原则 (参考 4.6 节 ) ，resultMap 和 resultList 两 个 Map 对 象 的 键 值 都 将 是 对 应 


的 get/set 方 法 都 是 针对 于 BaseMessage 类 的 属性 来 设计 的 ; 比如 ，getCode 和 setCode 就 是 属性 code 的 读 写 方法 ， 而 getMessage 和 setMessage 则 是 


这 些 方法 的 使 用 范例 都 可 在 代码 清单 7-36 中 的 getMessage 方 法 中 找到 。 


(3) setResult 方 法 


和 其 他 的 set 方 法 不 


同 ，setResult 方 法 是 BaseMessage 类 中 消息 数据 的 解析 逻辑 所 在 ， 也 是 该 类 最 核心 的 方法 。 首 先 ， 记 录 下 参数 传 入 的 JSON 消 息 中 的 result 激 据 集 


resultSrc 中 。 然 后 ， 使 


resultMap 中 ; 但 假如 是 个 对 象 数组 ， 则 需要 使 用 SONArray 来 对 对 象 数组 遍历 并 转化 ， 最 终 得 到 模型 对 象 数组 ， 再 存储 到 类 属性 resultList 中 去 。 


(4) getResult 方 法 


属性 message 的 读 写 方法 ， 


的 字符 源码 ， 并 保存 到 类 属性 
JSONObject 对 象 解析 result 数 据 集 的 最 外 层 数据 ， 这 是 因为 result 数 据 是 对 象 结构 的 。 接 着 ， 使 用 JSONObject 对 象 的 迭代 器 lterator 模 式 遍历 并 解析 result 数 据 集中 的 每 个 模型 数 
据 ， 模 型 名 称 通过 getModelName 方 法 来 获取 ， 而 模型 数据 则 根据 不 同 的 数据 类 型 来 做 分 别处 理 ; 如 果 模 型 数据 是 单个 对 象 ， 则 使 用 son2mode| 方 法 直接 转化 成 对 应 的 和 


个 模型 对 象 ， 并 存储 到 类 属性 


获取 通过 setResult 方 法 解析 得 到 的 单个 对 象 型 数据 ， 该 方法 的 参数 只 有 一 个 ， 也 就 是 数据 模型 的 名 称 。 当 该 方法 得 到 传 入 的 模型 名 称 时 ， 会 从 resultMap 中 得 到 对 应 的 模型 数据 ， 返 回 值 为 单个 模型 对 


象 。 


(5) getResultList 方 法 


此 方法 的 用 法 和 getResult 一 样 ， 只 不 过 该 方法 返回 的 是 对 应 模型 的 对 象 数组 ， 且 这 些 数据 是 从 resultList 中 得 到 的 。 


(6) json2mode| 方 法 


此 方法 在 setResult 中 被 用 于 模型 对 象 的 转化 ， 首 先 使 用 Class 类 的 forName 方 法 来 动态 创建 指定 模型 的 对 象 ， 然 后 使 用 Java 对 象 的 反射 (Reflection) 特性 来 给 模型 对 象 动态 注入 属性 值 ， 最 后 返回 组 装 


完成 的 模型 对 象 。 实 际 上 ， 这 种 做 法 经 常用 于 底层 框架 设计 或 者 底层 数据 映射 的 场景 中 ， 理 解 其 思路 对 于 加 强 Java 编 程 的 能 力 会 有 不 少 益处 。 


小 贴 士 : 反射 (Reflection) 是 Java 中 语言 的 强大 工具 。 它 让 我 们 能 够 创建 灵活 的 代码 ， 这 些 代码 可 以 在 运行 时 装配 ， 来 实现 一 些 动态 的 特性 和 功能 ; 但 需 注意 的 是 ， 反 射 的 成 本 很 高 ， 如 果 使 用 不 当 会 对 


系统 造成 额外 的 负担 。 此 外 ， 如 果 使 用 PHP 来 完成 动态 创建 类 的 功能 更 简单 ， 因 为 PHP 支 持 使 用 变量 来 初始 


JJ “SclassObj=new$class 


通过 7.1.3 节 中 对 登录 界面 控制 器 代码 的 逻辑 分 析 ， 我 们 了 解 到 在 微 博 框架 的 界面 控制 器 类 中 都 统一 使 有 


Name () ; ”语句 就 可 以 实现 动态 创建 对 象 的 功能 。 


化 对 象 的 写法 。 比 如 ， 我 们 把 类 名 赋值 给 变量 “gclassName”， 使 


doTaskAsyn<c 方 法 来 异步 发 送 网 络 请 求 ， 然 后 通过 onTaskComplete 方 法 来 处 理 数据 解析 之 后 的 


逻辑 ， 微 博客 户 端 框架 会 把 处 理 好 的 BaseMessage 对 象 传 给 onTaskComplete 方 法 供 我 们 使 用 。 例 如 ， 代 码 清单 7-20 所 示 的 登录 界面 控制 器 代码 的 onTaskComplete 方 法 中 就 使 用 了 getResult 方 法 来 获取 


Customer 模 型 对 象 。 


至 此 ， 我 们 已 经 了 解 微 博客 户 端的 程序 是 如 何 与 服务 端 API 进 行 网 络 通信 ， 解 析 返 回 的 JSON 格 式 数据 ， 最 终 映 射 成 可 用 的 模型 对 象 或 者 对 象 数组 的 整个 过 程 ; 并 且 ， 我 们 应 该 能 够 使 用 AppClient 和 


BaseMessage 类 来 完成 


客户 端 网 络 通信 的 功能 。 当 然 ， 我 们 还 会 在 后 面具 体 介绍 功能 界面 的 时 候 穿插 介绍 这 部 分 的 相关 内 容 。 


7.34 ”使 用 Toast 消 息 提示 


在 Android 系 统 中 Toast 也 叫 作 “简易 消息 提示 框 ”， 顾 名 思 义 ， 主 要 用 于 简单 信息 的 提示 ， 在 Android 应 用 开发 中 被 广泛 使 用 。 本 节 将 结合 网 络 通信 这 部 分 的 内 容 来 说 明 Toast 组 件 的 用 法 。Toast 类 使 


继承 自 BaseUi 的 界面 控制 器 类 中 直接 使 用 toast 方 法 ， 具 体 实 现 参考 代码 清单 7-38。 


起 来 非常 简单 ， 在 微 博客 户 端 框架 的 界面 基础 类 BaseUi 中 已 经 被 封装 成 了 toast 方 法 ， 该 方法 的 逻辑 很 简单 ， 传 入 提示 消息 的 String 字 符 串 ， 然 后 调用 Toast 类 的 静态 方法 makeText 即 可 ， 我 们 可 以 在 所 有 


代码 清单 7-38 


public class BaseUi extends Activity { 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void toast (String msg) { 


Toast .makeText (this, msg, Toast .LENGTH_SHORT) . show () ; 
l 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


public void doTaskAsync (int taskId, String taskUrl, HashMap<String, String» taskArgs) { 
showLoadBar () ; 


taskPool.addTask(taskId, taskUrl, taskArgs, new BaseTask()í 
GOverride 


public void onComplete (String httpResult) ( 
sendMessage (BaseTask.TASK COMPLETE, this.getId(), httpResult); 
} 


GOverride 
public void onError (String error) ( 

sendMessage (BaseTask.NETWORK ERROR, this.getId(), null); 
} 


}, 0); 
} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onNetworkError (int taskId) { 


toast (C.err.network) ; 
l 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
) 


以 上 代码 截取 自 BaseUi 类 ， 除 了 toast 方 法 的 实现 逻辑 之 外 ， 还 包含 了 doTaskAsyn<c 方 法 的 逻辑 ， 我 们 看 到 在 该 方法 创建 任务 的 逻辑 中 ， 使 


到 了 BaseTask 对 象 ， 而 该 对 象 的 onError 接 口 方法 中 又 使 
印 出 C.err.network 常 量 对 应 的 提示 信息 ， 即 “网 络 错 


到 了 sendMessage 方 法 ， 该 方法 的 具体 实现 会 在 7.4.2 节 中 做 详细 解释 ， 这 里 我 们 只 需要 知道 的 是 此 方法 会 触发 onNetworkError 方 法 的 逻辑 ， 的 
误 ” 信 息 。 也 就 是 说， 在 设备 未 联网 或 者 服务 端 API 接 口 连接 失败 的 时 候 就 会 弹出 这 个 错误 信息 ，Toast 的 弹出 效果 见 


D 


7-11. 


密码 e 


Witren] aa 


x 


示 上 ，Toast 组 件 在 微 博 应 


中 的 


处 非常 多 ， 


图 7-11 


Toast 弹 出 效果 


除了 


于 各 种 异常 情况 的 消息 提示 之 外 ， 还 
登录 界面 控制 器 类 UiLogin ( 见 代码 清单 7-20) 的 登录 多 辑 代码 中 看 到 toast 方 法 的 应 用 。 


当然 ,我 们 也 可 以 自 定义 Toast 的 外 观 和 行为 ， 该 类 给 我 们 提供 了 设置 弹出 位 置 (setGravity) 
(setView) 等 方法 来 灵活 地 自 定义 Toast 弹 出 框 的 样式 ， 相 关 示 例 见 代码 清单 7-39。 


代码 清单 7-39 


Toast toast = new Toast (getApplicationContext ()); 


// 设置 弹出 位 置 


toast. setGravity (Gravity.CENTER VERTICAL, 0, 0); 


// 设置 弹出 时 间 


toast. setDuration (Toast .LENGTH LONG); 


// 使 用 自 定义 模板 


toast. setView (layout); 


toast.show(); 


74 异步 任务 模块 


在 Android 应 


74.1 ”进程 和 线程 
为 更 好 地 理解 异步 任务 的 概念 ， 首 先 应 该 了 解 Android 系 统 进程 (Process) 和 线程 (Thread) 的 概念 。 
件 都 运行 在 同一 个 进程 中 ; 当然 ， 如 果 我 们 需要 控制 组 件 所 属 的 进程 ， 可 以 在 应 


于 一 些 操作 结果 的 提示 ， 比 如 添加 关注 成 功 ， 头 像 修改 成 功 以 及 登录 失败 的 提示 ， 关 于 这 点 我 们 还 可 以 在 


、 弹 出 时 间 (setDuration) 、 边 框 宽度 (setMargin) 、 设 置 文字 (setText) 以 及 设置 外 观 


中 ， 大 部 分 耗 时 的 逻辑 和 操作 都 必须 是 异步 的 ， 原 
界面 泻 染 和 事件 响应 之 外 的 逻辑 和 操作 。 对 于 微 博 客 
节 ) 两 大 部 件 ， 下 面 我 们 将 详细 分 析 这 两 个 部 件 的 代码 实现 和 异步 任务 模块 的 使 


因 


户 端 程序 来 说， 异步 任务 模块 就 是 被 设计 


是 这 样 不 会 影响 到 UI 主线 程 的 运行 ， 可 以 让 应 用 运行 地 更 流畅 ; 


其 实 从 本 质 上 来 说 ， 就 是 在 Ul 主线 程 之 外 再 新 建 一 个 线程 来 处 理 UI 


方法 。 


了 android: process 


属性 来 指定 所 属 的 进程 。 


Android 进 程 有 


己 的 生命 周期 ， 不 同类 型 的 应 


: 前 台 进程 : Foreground process， 即 当前 正在 运行 


不 会 很 多 ， 这 些 进程 不 会 轻易 结束 ， 除 非 系 统 的 可 用 内 


- 可 见 进程 : Visible brocess， 即 可 见 进程 。 


: 服务 进程 : 


可 见 进 程 的 运行 。 


Service process， 即 服务 进程 。 


所 属 进程 的 生命 周期 也 各 不 相同 。 下 面 


于 处 理 这 种 情况 的 ， 该 模块 是 由 多 个 部 件 组 合 而 成 的 ， 主 要 包括 任务 创建 ( 见 7.4.2 节 ) 和 任务 处 理 ( 见 7.4.3 


当 Android 应 上 


启动 的 时 候 ， 会 启动 一 个 带 单线 程 的 独立 进程 ， 在 默认 情况 下 ， 应 上 


中 的 所 有 组 


配置 文件 AndroidManifest.xml 中 设置 ，<activity>、<service>、<receiver> 和 <provider> 几 个 重要 组 件 的 标签 都 提供 


我 们 将 按照 优先 级 从 高 到 低 的 顺序 介绍 几 种 常见 的 进程 。 


的 进程 。 当 存在 正在 运行 的 Acitivty ( 即 onResume 方 法 被 调用 ) 或 者 活动 的 Service 服 务 时 ， 该 进程 便 属于 前 台 进 程 。Android 系 统 中 同时 运行 的 前 台 进 程 
存 已 经 到 达 仅 能 支持 UI 展现 的 底 限 。 


当 进 程 中 的 Activity 界 面 被 暂时 放 到 下 层 ， 即 onPause 方 法 被 调用 时 ， 该 进程 就 成 为 了 可 见 进程 。 这 些 进程 也 不 会 轻易 结束 ， 除 非 系统 的 可 用 内 存 已 经 不 能 支撑 


当 我 们 使 用 startService 方 法 来 启动 服务 的 时 候 ， 就 会 开启 一 个 服务 进程 ， 该 进程 与 应 用 进程 无 关 ， 系 统 会 保持 其 运行 状态 ， 直 到 系统 内 存 无 法 支持 前 台 进 程 和 


: 后 台 进程 : Background process， 即 后 台 进 程 。 当 进程 中 的 Activity 界 面 被 停止 ， 即 onStop 方 法 被 调用 时 ， 该 进程 就 变 为 后 台 进 程 ， 系 统 可 以 随时 杀 死 (kill) 这 些 进程 并 回收 它们 的 内 存 空 间 。 一 般 来 


说 ， 后 台 进程 中 会 存在 一 个 LRU 列 表 ， 越 少 使 用 的 进程 会 越 早 被 杀 死 。 


小 贴 士 : LRU (Least Recently Used) 即 最 近 最 少 使 用 算法 ， 属 于 内 存 管理 的 重要 算法 ， 该 算法 属于 淘汰 算法 ， 太 久 没 有 使 用 的 进程 最 终 会 被 淘汰 ， 使 用 该 算法 可 以 让 资源 得 到 更 合理 的 分 配 ， 经 常用 于 


管理 内 存 和 缓存 。 


需要 注意 的 是 ，Android 系 统 会 采 


进程 。 


学 习 了 Android 系 统 进程 的 相关 知识 后 ， 我 们 再 来 认识 一 下 线程 (Thread) 的 概念 。 


消息 事件 的 分 发 ， 
阻塞 UI 线程 ， 影 响应 


的 


以 上 问题 的 解决 方案 有 几 种 ， 我 介 
一 种 更 为 基础 的 方案 ， 即 使 


们 将 采 
线程 的 用 法 。 


在 这 里 ， 简 单 介绍 一 下 进程 和 线程 之 


此 我 们 也 称 之 为 U 


线程 。 由 


] 可 以 使 


UI 线程 负责 的 
运行 效果 。 另 外 ，Android 系 统 中 的 许多 UI 组 件 不 是 线程 安全 的 ， 所 以 我 们 还 需要 尽量 如 免 在 新 线程 中 直接 使 


Procedure Calls 远 程 调 


B) 


向 应 有 


A 的 进程 (进程 A) 发 起 IPC 调 有 
接口 则 存在 于 进程 A 中 的 某 个 Binder 线 程 中 ， 整 个 调用 过 程 的 示意 图 


的 模式 来 进行 的 ， 我 们 需要 


间 的 通信 问题 。 首 先是 进程 间 的 
到 AIDL (Android 


“最 高 优先 ”的 原则 来 排列 进程 的 优先 级 ， 假 如 一 个 进程 中 同时 存在 一 个 Service 服 务 和 一 个 处 于 可 见 状态 的 Activity， 那 么 这 个 进程 将 被 认为 是 可 见 进程 而 不 是 服务 


UI 组 件 View 类 中 的 post 和 postDelay 方 法 来 添加 处 理 罗 辑 到 消息 队列 中 ， 也 可 以 使 
Handler 类 配合 自己 实现 的 任务 线程 池 来 完成 异步 任务 的 处 理 。 接 下 来 ， 我 们 将 通过 对 微 博 应 用 实例 的 异步 任务 模块 的 实现 介绍 ， 来 进一步 理解 Android 系 统 中 对 Java 


， 那 么 进程 B 中 的 程序 会 通过 其 AlDL 生 成 的 应 


D 


= 


zE 


数据 通信 ， 该 过 程 称 为 IPC (Interprocess Communication) ， 在 Android 系 统 中 ， 进 程 之 间 通 信 征 采 上 
nterface Definition Language) 来 配合 实现 。 整 个 过 程 比较 复杂 ， 这 里 
A 的 代理 类 (Proxy) ， 向 进程 A 中 的 Stub 接 
7-12 中 左下 方 与 Binder 有 关 的 部 分 。 


当 应 用 启动 时 ， 其 所 处 的 进程 会 创建 一 个 主线 程 ， 即 Main Thread。 该 线程 非常 重要 ， 它 主要 负责 UI 界面 的 泻 染 和 
情 非 常 多 ， 甚 至 还 包括 和 系统 UI 组 件 之 间 的 消息 通信 ， 所 以 我 们 在 处 理 一些 耗 时 、 耗 资源 的 逻辑 的 时 候 尽量 启动 新 的 线程 来 处 理 ， 以 避免 


主线 程 中 的 UI 组 件 对 象 。 


中 我 


系统 提供 的 AsyncTask 类 来 处 理 这 些 异 步 的 逻辑 ， 不 过 在 微 博 应 


RPCs, BDRemote 
一 个 例子 来 说 明 这 个 过 程 。 假 如 ， 应 用 B 的 进程 (进程 
。 其 中 ， 应 用 A 的 代理 类 存在 于 进程 8 中 ， 而 应 用 A 的 Stub 


系统 服务 
(System Service ) 


进程 
( Process A ) 


线程 
(Thread A ) 


消息 队列 (Message Queue ) 


Message 


Binder Driver 


Binder Proxy 


进程 
( Process B ) 


| Message 


Ste 


Looper 


Binder 472 


Binder Stub Interface 


图 7-12 ”进程 & 线 程 调用 图 


其 次 ， 就 是 线程 间 的 数据 通信 ， 也 就 是 应 用 进程 内 部 的 消息 通信 。 线 程 间 的 数据 通信 相对 比较 简单 ， 图 7-12 中 已 经 比较 清楚 地 描绘 了 Android 应 | 
程 或 者 UI 线程 ， 该 线程 内 部 维护 了 一 个 消息 队列 (可 使 用 Looper 进 行 控制 ) ， 不 同 的 Message 消 息 将 会 分 配给 对 应 的 Handler 来 处 理 。 假 如 ， 现 在 有 个 逻辑 线程 (线程 B) 需要 与 UI 线程 (线程 A) 通信 ， 
只 需要 在 线程 B 的 逻辑 处 理 完毕 之 后 ， 将 指定 消息 发 送 到 线程 A 消 息 队 列 中 即 可 ， 至 于 分 配给 哪个 Handler 来 处 理 都 是 可 以 指定 的 。 


线程 
( Thread B ) 


线程 
( Thread N ) 


内 部 的 线程 通信 的 过 程 。 其 实 线程 A 就 是 前 面 说 的 主线 


实际 上 ， 异 步 任务 的 执行 过 程 也 就 是 任务 线程 和 UI 线程 之 间 的 通信 过 程 ， 接 下 来 我 们 将 介绍 在 微 博 客户 端 程序 中 是 如 何 实现 异步 任务 的 。 而 这 部 分 内 容 正 好 可 以 作为 线程 间 通 信 的 实例 ， 大 家 在 学 习 的 


过 程 中 结合 本 节 介 绍 的 内 容 来 理解 ， 会 有 事半功倍 的 效果 。 


742 ”任务 创建 Thread 


前 面 介绍 过 ， 
介绍 一 下 。 首 先 ，BaseTask 是 基础 任务 类 ， 定 义 了 异步 任务 必要 属性 和 方法 


代码 清单 7-40 


， 以 及 任务 的 种 类 ， 该 类 如 代码 清单 7-40 所 示 。 


异步 任务 模块 是 由 两 大 部 件 组 合 而 成 的 。 任 务 创建 部 件 就 是 异步 任务 模块 中 非常 重要 的 一 环 ， 这 部 分 包括 基础 任务 BaseTask 类 和 基础 任务 池 类 BaseTaskPoo| 两 方面 内 容 ， 下 面 我 们 分 别 


package com.app.demos.base; 

public class BaseTask { 
public static final int TASK COMPLETE = 0; 
public static final int NETWORK ERROR = 1; 
public static final int SHOW LOADBAR - 2; 


public static final int HIDE LOADBAR = 3; 
public static final int SHOW TOAST - 4; 
public static final int LOAD IMAGE = 5; 
private int id = 0; 
private String name - ""; 
public BaseTask() () 
public int getId () ( 

return this.id; 
) 


public void setId (int id) { 
this.id = id; 


} 

public String getName () { 
return this.name; 

} 


public void setName (String name) { 
this.name = name; 


lae void onStart () { 

public void onComplete () { 

1 ies void onComplete (String httpResult) ( 
public void onError (String error) ( 


public void onStop () throws Exception { 
} 


下 面 分 析 BaseTask 的 代码 。 首 先 ， 该 类 定义 了 基本 任务 的 类 型 ， 这 些 类 


型 常量 会 在 任务 处 理 的 时 候 被 使 用 ， 对 应 任务 类 型 的 使 用 逻辑 请 参考 7.4.3 节 中 BaseHandler 类 的 相关 内 容 ， 现 把 各 个 类 型 的 用 法 


归纳 如 下 。 


: TASK COMPLETE: 普通 任务 ， 绝 大 部 分 的 异步 任务 都 属于 这 种 类 型 ， 这 种 任务 会 在 异步 请 求 返回 结果 之 后 ， 在 onTaskComplete 方 法 中 进行 逻辑 处 理 。 


: NETWORK ERROR: 网 络 异常 任务 ， 在 网 络 出 现 问题 的 时 候 被 使 用 。 


: SHOW LOADBAR: 显示 等 待 进度 条 ， 该 任务 执行 时 会 显示 等 待 进度 条 。 


: HIDE_LOADBAR: 隐藏 等 待 进度 条 ， 执 行 该 任务 将 隐藏 等 待 进度 条 。 


: SHOW TOAST: 消息 提示 任务 ， 执 行 该 任务 将 弹出 需要 显示 的 信息 。 


: LOAD IMAGE: 加 载 图 片 任务 ， 该 任务 在 需要 异步 加 载 图 片 的 时 候 被 使 用 。 


任务 的 


其 次 ，BaseTask 中 还 定义 了 基本 任务 必要 
唯一 标识 。 


“onstart: 任务 开始 接口 方法 ， 在 异步 任务 开始 之 前 被 调用 。 


-onComplete: 任务 结束 接口 方法 ， 在 异步 任务 结束 之 后 被 调用 。 


-onError: 任务 出 错 接口 方法 ， 任 务 执 行 出 现 异 常 时 被 调用 。 


-onStop: 任务 结束 接口 方法 ， 任 务 完全 结束 之 后 被 调用 。 


实际 上 ，BaseTask 更 像 是 个 任务 接口 ， 以 上 生命 周期 方法 都 是 定义 . 
BaseTaskPool 中 实现 的 ， 该 类 代码 如 代码 清单 7-41 所 示 。 


属性 ， 包 括 任务 ID (id) 和 任务 名 (name) ， 我 们 可 以 使 用 对 应 的 get/set 方 法 来 获取 和 设置 。 其 中 ， 我 们 特别 需要 注意 任务 1D 的 使 用 ， 因 为 该 


属性 被 当做 是 


另外 ，BaseTask 类 还 定义 了 基本 任务 生命 周期 的 接口 方法 ， 列 举 说 明 如 下 。 


体 任务 时 


代码 清单 7-41 


要 实现 的 接口 方法 ， 在 任务 创建 和 执行 的 过 程 中 会 被 调用 。 而 任务 创建 和 执行 的 逻辑 都 是 在 基础 任务 池 类 


package com.app.demos.base; 
import java.util.HashMap; 
import java.util.concurrent .ExecutorService; 


import java.util.concurrent .Executors; 
import android.content.Context; 

import com.app.demos.util.HttpUtil; 
import com.app.demos.util.AppClient; 
public class BaseTaskPool { 


// 线程 池 对 象 
static private ExecutorService taskPool; 
// 界面 上 下 文 对 象 
private Context context; 
// 初始 化 任务 线程 池 
public BaseTaskPool (BaseUi ui) { 
this.context = ui.getContext (); 
taskPool = Executors.newCachedThreadPool () ; 


} 
// 创建 异步 远程 任务 方法 (SHR 


public void addTask (int taskId, String taskUrl, HashMap<String, String> 


taskArgs, BaseTask baseTask, int delayTime) { 
baseTask.setId(taskId) ; 
try { 


taskPool.execute (new TaskThread(context, taskUrl, taskArgs, 


baseTask, delayTime) ); 
} catch (Exception e) { 
taskPool. shutdown () ; 
} 


} 
// 创建 异步 远程 任务 方法 〈 不 含 参数 ) 


public void addTask (int taskId, String taskUrl, BaseTask baseTask, int delayTime) { 


baseTask.setId (taskId) ; 
try { 


taskPool.execute (new TaskThread (context, taskUrl, null, baseTask, delayTime) ); 


} catch (Exception e) { 
taskPool. shutdown () 7 
l 


š 
// 创建 自 定义 异步 任务 


Public void addTask (int taskId, BaseTask baseTask, int delayTime) { 


baseTask.setId(taskId); 
try ( 


taskPool.execute (new TaskThread (context, null, null, baseTask, delayTime)); 


} catch (Exception e) ( 
taskPool. shutdown () ; 
} 


} 

// 43258 AUS A 

private class TaskThread implements Runnable { 
private Context context; 
private String taskUrl; 
private HashMap<String, String> taskArg; 
private BaseTask baseTask; 
private int delayTime = 0; 


public TaskThread(Context context, String taskUrl, HashMap<String, 
String> taskArgs, BaseTask baseTask, int delayTime) { 


this.context = context; 
this.taskUrl = taskUrl; 
this.taskArgs = taskArgs; 
this.baseTask = baseTask; 
this.delayTime = delayTime; 


} 
GOverride 
public void run() { 
try ( 
baseTask.onStart (); 
String httpResult - null; 
// 设置 任务 延 时 
if (this.delayTime > 0) { 
Thread.sleep (this.delayTime) ; 
] 
try ( 
// 远程 任务 
if (this.taskUrl != null) { 
// 初始 化 AppClient 


AppClient client = new AppClient (this.taskUrl); 
if (HttpUtil.WAP INT == HttpUtil.getNetType (context)) { 


client.useWap(); 


l 
// GET 请 求 
if (taskArgs == null) { 


httpResult = client.get(); 


// POST 请 求 
) else ( 


httpResult = client.post (this.taskArgs) ; 


} 


} 
// 远程 任务 处 理 
if (httpResult != null) { 


baseTask.onComplete (httpResult); 


// 本 地 任务 处 理 


} else { 


baseTask.onComplete () ; 


} catch (Exception e) { 
baseTask.onError (e.getMessage () ) ; 


} catch (Exception e) { 
e.printStackTrace () ; 
} finally { 
try { 
// 任务 结束 
baseTask.onStop(); 
} catch (Exception e) ( 
e.printStackTrace|(); 


} 


上 述 BaseTaskPool 类 是 执行 异步 任务 的 核心 逻辑 所 在 ， 也 是 我 们 需要 年 


点 分 析 的 部 分 。 我 们 按照 阅读 顺序 ， 将 此 类 的 知识 要 点 罗列 如 下 。 


1 .线程 池 使 

从 BaseTaskPool 类 的 构造 方法 中 ， 我 们 可 以 看 到 ， 这 里 使 用 的 是 缓存 线程 池 newCached-ThreadPool， 该 线程 池 实 现 了 缓存 的 重用 以 及 过 期 线程 的 清除 ， 比 较 适 合 于 短期 异步 任务 的 执行 ; 不 过 和 固 
定 线程 池 不 同 的 是 它 没有 限制 线程 的 个 数 ， 如 果 使 用 不 当 有 可 能 造成 性 能 问题 。 

2.addTask 方 法 

该 类 包含 了 3 个 addTask 方 法 ， 前 面 两 个 方法 用 于 处 理 异 步 远程 任务 ， 所 谓 异 步 远程 就 是 需要 请 求 服务 端 API 接 口 的 任务 ， 这 两 个 方法 都 需要 传 入 参数 包括 任务 ID (taskld) ，API 接 口 地址 
(taskUrl) ， 任 务 接口 对 象 (baseTask) 以 及 任务 延 时 秒 数 (delayTime) ; 而 其 中 一 个 方法 还 支持 传 入 AP| 接 口 参数 (taskArgs) 。 后 面 一 个 方法 用 于 处 理 自 定义 异步 任务 ， 这 些 任务 一 般 是 无 需 请 求 服 
务 端 API 接 口 的 “本 地 任务 ”。 

3.TaskThread 类 

任务 线程 类 实现 了 Runnable 接 口 ， 是 任务 线程 的 主要 逻辑 所 在 ， 我 们 主要 分 析 run 接 口 方法 的 逻辑 。 首 先 ， 程 序 调用 了 baseTask 的 onStart 方 法 ， 这 里 执行 的 就 是 任务 的 开始 逻辑 ; 接着 ， 设 置 延 时 ， 


有 些 异 步 任务 是 需要 延 时 进行 的 ， 这 里 就 是 其 延 时 功能 的 实现 逻辑 ; 然后 ， 就 进入 了 网 络 通信 的 标准 逻辑 ， 这 点 我 们 在 


果 的 时 候 调 


了 baseTask 的 onComplete 方 法 ， 执 行 任务 完成 逻辑 ; 最 后 ， 进 行 任务 收 | 


尾 处 理 ， 如 果 捕 获 到 异常 则 调 有 


实际 上 ， 在 微 博客 


户 端 程序 框架 中 ，BaseTaskPool 已 经 被 封装 到 界面 基础 类 BaseUi 中 ， 上 


析 一 下 。 


addTask 方 法 是 对 应 的 ， 


代码 清单 7-42 


前 面 7.3.1 节 对 AppClient 类 | 
baseTask 的 onError 方 法 ， 并 在 结束 的 时 候 调 有 


doTaskAsync 异 步 任务 方法 的 逻辑 实现 ， 代 码 清 和 


的 介绍 中 已 经 分 析 过 了 ， 不 再 乾 述 ;当然 ， 在 请 求 返回 结 
onStop 方 法 。 


7-42 截 取 的 就 是 BaseUi 类 中 的 相关 代码 ， 我 们 来 简单 分 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 初始 化 异步 任务 池 
this .taskPool = new BaseTaskPool (this); 


} 

// 自 定义 任务 

Public void doTaskAsync (int taskId, BaseTask baseTask, int delayTime) 
taskPool.addTask(taskId, baseTask, delayTime) ; 


{ 


l 
// 异步 远程 任务 (不 含 参 数 ) 
public void doTaskAsync (int taskId, String taskUrl) 
showLoadBar () ; 
taskPool.addTask(taskId, taskUrl, new BaseTask() { 
GOverride 
public void onComplete (String httpResult) 


{ 


{ 
sendMessage (BaseTask.TASK COMPLETE, this.getId(), httpResult); 
l 
GOverride 
public void onError (String error) ( 
sendMessage (BaseTask.NETWORK ERROR, this.getId(), null); 
} 
}, 0); 
š 
// 异步 远程 任务 〈( 含 参数 ) 
public void doTaskAsync (int taskId, String taskUrl, HashMap<String, String> taskArgs) 
showLoadBar () ; 
taskPool.addTask(taskId, taskUrl, taskArgs, new BaseTask()í 
GOverride 
public void onComplete (String httpResult) ( 
sendMessage (BaseTask.TASK COMPLETE, this.getId(), httpResult); 


{ 


} 

Override 

public void onError (String error) { 

sendMessage (BaseTask.NETWORK_ERROR, this.getId(), null); 

} 
}, 0); 

} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


首先 ， 程 序 在 界面 初始 化 方法 onCreate 中 创建 了 BaseTaskPool 类 对 应 的 taskPool 对 象 ， 然 后 在 后 面 的 3 个 异步 任务 方法 doTaskAsync 中 使 
分 别 用 于 异步 远程 任务 和 


失败 则 发 送 NETWORK_ERROR 类 型 的 任务 消息 ， 


7.4.3 ”任务 处 理 Handler 


为 a 
a 


在 上 节 中 ， 我 们 已 经 介绍 了 任务 创建 部 件 的 实现 ， 接 下 来 看 看 任务 处 理 部 件 。 从 线程 通信 的 角度 来 看 ， 任 务 处 理 其 实 就 是 消息 处 理 ， 在 Android 应 


ndroid.os.Handler。 在 异步 任务 模块 中 ， 当 任务 处 理 完毕 
17-43, 


uU 


代码 清单 7-43 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onCreate (Bundle savedInstanceState) { ~ 
super .onCreate (savedInstanceState) ; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


// 初始 化 任务 处 理 器 


定义 任务 的 执行 。 这 里 我 们 需要 注意 的 是 3 个 方法 中 对 应 addTask 方 法 的 使 用 ;对 于 这 点 ， 建 议 大 家 可 以 结合 之 前 我 们 对 
法 的 介绍 来 学 习 和 理解 。 另 外 ， 任 务 对 象 的 onComplete 和 onError 方 法 也 需要 留意 一 下 ， 
讲 过 ， 成 功 则 发 送 TASK_COMPLETE 类 型 的 任务 消息 ， 


; doTaskAsync 方 法 的 使 用 和 BaseTaskPoo| 类 中 的 


BaseTaskPool 类 中 addTask 方 


中 sendMessage 方 法 用 于 发 送 任务 消息 到 Handler 处 理 器 ， 而 发 送 任务 的 类 型 我 们 在 介绍 BaseTask 的 时 候 曾 经 
而 关于 任务 处 理 器 Handler 的 知识 ， 我 人 


门将 在 7.4.3 节 里 给 大 家 做 详细 介绍 。 


框架 中 ， 我 们 一 般 使 


Handler 类 来 实现 ， 对 应 类 包 


后 ， 程 序 会 发 送 任务 消息 给 对 应 的 消息 处 理 器 Handler 来 处 理 ， 而 发 送 消息 的 逻辑 就 在 BaseUi 类 中 的 sendMessage 方 法 里 ， 相 关 代 码 见 代码 


this.handler = new BaseHandler (this) ; 


} 


public void sendMessage (int what) { 
Message m = new Message (); 
m.what = what; 
handler.sendMessage (m) ; 


} 


public void sendMessage (int what, String data) { 


Bundle b = 


new Bundle () ; 


b.putString("data", data); 
Message m = new Message () 7 
m.what = what; 

m.setData (b); 
handler.sendMessage (m) ; 


} 


public void sendMessage (int what, int taskId, String data) { 


Bundle b = 
b.putInt ("ti 


new Bundle (); 
ask", taskId); 


b.putString("data", data); 


Message m = 
m.what = wh. 
m.setData (b 


new Message () ; 
at; 


); 


handler.sendMessage (m) ; 


} 
l 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


以 上 是 BaseUi 类 中 与 消息 发 送 功能 有 关 的 代码 ， 建 议 大 家 把 这 段 代 码 与 代码 清单 7-42 中 和 任务 创建 部 分 的 逻辑 结合 起 来 理解 。 代 码 中 的 3 个 sendMessage 方 法 从 上 到 下 分 别 用 于 发 送 不 带 数据 的 消息 、 


带 数据 的 消息 以 及 指定 任务 ID 并 | 


BaseHandler 处 理 器 类 的 实现 请 参考 代码 清单 7-44。 


代码 清单 7-44 


package com.app.demos.base; 

import com.app.demos.util.AppUtil; 

import android.os.Handler; 

import android.os.Looper; 

import android.os.Message; 

public class BaseHandler extends Handler ( 
protected BaseUi ui; 
public BaseHandler (BaseUi ui) ( 

this.ui = ui; 


) 


public BaseHandler (Looper looper) ( 
super (1ooper) ; 


} 
GOverride 


public void handleMessage (Message msg) ( 


try { 


int taskId; 
String result; 
switch (msg.what) ( 


} 
} catch (Exc 


case BaseTask.TASK COMPLETE: 
ui.hideLoadBar () ; 
taskId = msg.getData() .getInt ("task"); 
result = msg.getData () .getString ("data"); 
if (result != null) { 


目 带 数据 的 消息 。 在 之 前 的 doTaskAsync 方 法 中 ， 我 们 使 有 


的 是 最 后 一 个 方法 ， 该 方法 会 把 任务 类 型 、 任 务 ID 以 及 消息 数据 全 部 发 送 给 BaseHandler 对 象 来 处 理 ， 而 


ui.onTaskComplete (taskId, AppUtil.getMessage (result) ) 7 


} else if (!AppUtil.isEmptyInt (LaskId)) { 
ui.onTaskComplete (taskId) ; 
} else { 
ui.toast (C.err.message) ; 
} 
break; 
case BaseTask.NETWORK_ERROR: 
ui.hideLoadBar () ; 
taskId = msg.getData() .getInt ("task"); 
ui.onNetworkError (taskId) ; 
break; 
case BaseTask.SHOW LOADBAR: 
ui.showLoadBar(); 
break; 
case BaseTask.HIDE LOADBAR: 
ui.hideLoadBar () ; 
break; 
case BaseTask.SHOW TOAST: 
ui.hideLoadBar () ; 
result = msg.getData () .getString ("data"); 
ui.toast (result); 
break; 


eption e) ( 


e.printStackTrace (); 


ui.toa: 


st (e.getMessage () ) ; 


BaseHandler 类 最 重要 的 逻辑 都 被 实现 在 handleMessage 方 法 中 ， 这 里 面包 含 了 各 种 任务 类 型 对 应 的 处 理 逻 辑 。7.4.2 节 中 我 们 简要 介绍 了 BaseTask， 即 基础 任务 类 中 定义 的 任务 类 型 ， 如 普通 任务 
(TASK COMPLETE) 、 网 络 异常 任务 (NETWORK ERROR) 以 及 消息 提示 任务 (SHOW TOAST) 等 ， 大 家 可 以 对 照 代码 学 习 和 理解 这 些 任务 的 处 理 逻 辑 ， 而 这 些 任务 的 处 理 逻 辑 中 都 会 使 用 到 界面 上 下 


文 对 象 ， 该 对 象 在 初始 化 BaseHandler 类 的 时 候 ， 将 从 BaseUi 类 的 onCreate 方 法 中 被 传 进来 ， 代 表 的 也 就 是 当前 界面 的 上 下 文 对 象 。 另 外 ， 在 普通 任务 的 处 理 逻 辑 中 我 们 可 以 看 到 onTaskComplete 
， 以 及 JSON 消 息 处 理 方法 getMessage 的 用 法 。 


法 的 使 


至 此 ， 异 步 任务 模块 的 代码 实现 部 分 的 内 容 已 经 介绍 完毕 ， 我 们 可 以 把 异步 任务 的 实现 逻辑 总 结 如 下 : 使 
sendMessage 方 法 发 送 对 应 的 任务 消息 给 BaseHandler 处 理 ; 对 了 
BaseMessage 的 相关 内 容 ， 这 些 模块 一 起 构成 了 微 博 应 


744 ”使 用 异步 任务 AsyncTask 


通过 前 面 对 异 步 任务 模块 的 介绍 ， 我 们 可 以 总 结 出 以 下 〈 见 代码 清单 7-45) 格式 的 代码 模板 来 供给 具体 的 界面 控制 器 类 使 


以 下 代码 模板 来 完成 异步 任务 的 功能 。 


代码 清单 7-45 


普通 异步 任务 来 说 ， 即 调 


客户 端的 远程 任务 处 理 系统 的 核心 。 


public class UiTest extends BaseUi { 


[n 


调 方 


步 任务 池 类 BaseTaskPool 来 创建 BaseTask 任 务 的 线程 ， 该 线程 运行 完毕 后 使 用 
onTaskComplete 方 法 来 处 理 任务 完成 后 的 逻辑 ， 其 中 还 涉及 网 络 通信 类 AppClient 以 及 基础 消息 类 


。 实 际 上 只 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


public void onCreate (Bundle savedInstanceState) { 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


// 创建 异步 任务 
doTaskAsync(taskId, apiUrl, apiParams); 
} 


public void onTaskComplete (int taskId, BaseMessage message) 


super.onTaskComplete (taskId, message); 


// 处 理 异 步 任务 


{ 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


界面 控制 器 类 继承 自 BaseUi 或 者 BaseUiAuth 类 ， 就 可 以 使 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


当然 ，Android 系 统 本 身 也 给 我 们 提供 了 一 些 不 错 的 异步 任务 的 解决 方案 ，AsyncTask 就 是 其 中 比较 常 
多 信息 可 参考 SDK 中 的 android.os.AsyncTask 类 说 明 。 


- onPreExecute: 在 异步 逻辑 开始 之 前 被 执行 ， 通 常用 于 处 理 一 些 初 始 化 工作 。 


的 一 种 。 该 类 的 使 


加 
H 
当 
tot 


方法 比较 简单 ， 


的 抽象 方法 即 可 ， 


- dolnBackground: 在 onPreExecute 方 法 完成 后 被 执行 ， 用 于 处 理 比 较 耗 时 的 异步 任务 ， 相 当 于 微 博 客户 端 框架 中 BaseUi 类 中 的 doTaskAsync 方 法 。 


: onProgressUpdate: 在 异步 任务 执行 的 同时 被 执行 ， 即 和 doInBackground 同 步 运行 ， 常 用 于 展示 进度 的 进展 情况 。 
- onPostExecute: 在 异步 任务 执行 完成 后 ， 也 就 是 doInBackground 方 法 完成 之 后 被 执行 ， 相 当 于 BaseUi 类 中 的 onTaskComplete 方 法 。 
- onCancelled: 在 用 户 取消 线程 操作 的 时 候 调 用 。 


和 异步 任务 相似 的 ， 我 们 也 可 以 总 结 出 AsyncTask 使 用 方法 的 代码 模板 ， 如 代码 清和 
在 其 核心 接口 方法 中 添加 对 应 的 逻辑 代码 即 可 ， 使 


代码 清单 7-46 


7-46 中 所 示 。 这 里 的 TestAsyncTask 异 步 任 务 类 位 于 TestActivity 类 的 内 部 ， 继 承 
的 时 候 创建 该 类 的 对 象 并 执行 其 execute 方 法 即 可 ， 需 要 注意 的 是 这 里 的 参数 将 被 传 入 到 dolnBackground 方 法 中 去 。 


方法 说 明 列 举 如 下 ,更 


AsyncTask 抽 象 类 ， 我 们 只 需要 


public class TestActivity extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onCreate (Bundle savedInstanceState) 


// 使 用 异步 任务 类 


TestAsyncTask task = new TestAsyncTask (this) ; 
task.execute(paraml, param2, http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...)7 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


class TestAsyncTask extends AsyncTask<String, Integer, String> { 


public TestAsyncTask (Context context) 
// 初始 化 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


protected String doInBackground (Stringhttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/.. 
// 异步 逻辑 
protected vi 


protected void onPostExecute (String result) 
/ AERE 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
oid onProgressUpdate (Integerhttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/. . 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


. params) { 


. values) { 


对 比 以 上 两 种 最 3 
况 。 当 然 ，AsyncTask 的 使 用 也 很 简 香 


合适 的 处 理 方案 。 


7.5 ”全 局 功能 模块 


E 流 的 异步 任务 解决 方案 : 使 


an 


端的 主要 任务 就 是 获 


取 服 务 端 API 的 返回 


和 面 介绍 了 微 博客 户 端 程序 中 最 为 基础 的 两 个 核心 模块 ， 即 网 络 通 信 模 块 和 异步 任务 模块 ， 整 个 微 博 应 
都 会 放 在 服务 端 来 处 理 ， 而 客户 


结果 ， 解 析 并 进行 


绍 ， 我 们 将 根据 各 个 功能 界面 的 特点 来 介绍 不 同 的 应 


本 节 将 介绍 微 博 应 


件 ， 另 一 类 是 与 微 博 某 些 业务 功能 有 关 的 功能 模块 。 


7.5.1 全 局 Ul 基 类 


开发 技巧 ， 这 种 方式 能 让 大 家 更 深 讽 


微 博客 户 端 程序 框架 中 的 异步 任务 模块 ， 即 Thread 加 上 Handler 的 方案 ， 优 点 是 使 
和 R， 并 且 提 供 了 onProgressUpdate 方 法 来 获取 任务 进度 ， 不 过 在 多 个 异步 任务 并 行 的 情况 下 就 显得 有 点 力不从心 了 。 在 实际 项 目 中 ,我们 可 以 根据 实际 情况 选择 比较 


展示 ， 这 也 是 以 上 两 个 模 


的 逻辑 都 会 围 


方便 、 结 构 清晰 、 运 行 效率 高 ， 特 别 适 上 


绕 着 这 两 个 模块 来 开发 。 实 际 上 对 于 多 数 的 移动 互联 网 应 


于 多 个 异步 任务 并 行 的 情 


来 说 ， 大 部 分 的 逻辑 


。 本章 以 下 的 内 容 将 主 


地 理解 各 个 组 件 的 实际 


局 功能 模块 ， 准 确 来 说 是 除了 网 络 通信 模块 和 异步 任务 模块 这 些 基础 功能 模块 之 外 的 具有 全 


体 功能 界面 来 进行 介 


局 性 意义 的 功能 模块 ， 这 些 模块 可 粗略 分 为 两 大 类 ， 一 类 是 构成 UI 界面 的 公用 组 


首先 ， 微 博 应 用 中 所 有 的 界面 控制 器 类 都 被 放 到 com.app.demos.ui 类 包 之 下 ， 且 都 以 Ui 作 为 类 名 的 前 缀 。 界 面 控制 器 的 基 类 有 两 个 ， 即 BaseUi 和 BaseUiAuth，BaseUi 是 所 有 界面 控制 类 的 基 类 ， 而 


BaseUiAuth 则 是 所 有 登录 界 


控制 类 〈 即 框架 界 


) 的 基 类 。 当 然 ， 这 些 类 均 继承 


Android 应 用 框架 的 Activity 类 ,以 上 UI 界 


类 的 继承 关系 如 下 。 


Android.app.Activity 


|- com.app.demos.base.BaseUi 
|- com.app.demos. base.BaseUiAuth 
|- com.app.demos.ui.Uilndex 


实际 上 ， 在 前 面 章节 的 内 容 中 我 们 已 经 穿插 介绍 了 许多 界面 控制 器 基 类 BaseUi 的 相关 内 容 ， 我 们 将 该 类 中 的 常 
外 ， 由 于 BaseUi 类 的 代码 太 长 了 ， 我 们 无 法 在 这 里 贴 出 该 类 完整 的 代码 实现 ， 这 些 方 法 的 实现 逻辑 我 们 会 继续 采 上 


toast: 消息 提示 框 组 件 的 调用 方法 ， 可 参考 7.3.4 节 内 容 。 
- overlay: 在 当前 界面 之 上 鹤 盖 目标 界面 ， 可 参考 7.2.4 节 内 容 。 


: forward: 切换 当前 界面 至 目标 界面 ， 可 参考 7.2.4 节 内 容 。 


:getContext: 获取 当前 界面 的 上 下 文 对 象 ， 注 意 与 getApplicationContext 的 区 别 。 


: getHandler: 获取 当前 界面 的 消息 处 理 器 类 Handler， 可 参考 7.4.3 节 内 容 。 


setHandler: 设置 消息 处 理 器 类 Handletr， 可 用 于 设置 自 定义 的 消息 处 理 器 。 


- getLayout: 根据 ID 获取 对 应 的 模板 对 象 。 


方法 总 结 如 下 ， 在 后 


之 前 穿插 介绍 的 方式 来 给 大 家 分 别 解析 。 


面 对 微 博 应 用 界面 控制 器 类 的 介绍 都 将 会 涉及 这 些 方法 的 使 用 。 另 


: getTaskPool: 获取 异步 任务 池 ， 可 参考 7.4.2 节 内 容 。 

:showLoadBar: 显示 加 载 进度 条 ， 前 面 介 绍 异步 任务 模块 的 实现 时 也 有 提 及 。 
: hideLoadBar: 隐藏 加 载 进度 条 ， 与 showLoadBar 结 合 使 用 。 

- openDialog: 快速 打开 Dialog 窗 口 ， 可 参考 7.5.3 节 内 容 。 

: loadimage: 快速 加 载 远 程 图 片 ， 可 参考 7.7.5 节 中 相关 内 容 。 

: doFinish: 结束 当前 界面 。 

: doLogout: 用 户 注销 ， 可 参考 7.5.2 节 内 容 。 

: doEditText: 编辑 文本 ， 可 参考 7.9.3 节 内 容 。 

: doEditBlog: 编辑 微 博 ， 可 参考 7.9.4 节 内 容 。 

-sendMessage: 发 送 消息 ， 常 与 消息 处 理 器 类 Handler 配 合 使 用 。 

: doTaskAsync: 创建 新 的 异步 任务 ， 可 参考 7.4.2 节 内 容 。 

: onTaskComplete: 异步 任务 完成 后 的 回调 方法 ， 可 参考 7.4.2 节 内 容 。 


- onNetworkError: 网 络 异 常 回 调 方法 。 


: debugMemory: 获取 当前 占用 内 存 ， 可 参考 8.1.2 节 内 容 。 


BaseUiAuth 类 从 BaseUi 类 中 继承 了 上 述 的 所 有 方法 ， 此 外 ， 该 类 还 额外 添加 了 界面 通 


框架 以 及 应 


代码 清单 7-47 


的 逻辑 。 下 面 我 们 就 来 学 习 BaseUiAuth 类 的 完整 逻辑 ， 如 代码 清单 7-47 所 示 。 


package com.app.demos.base; 
import com.app.demos.R; 
import com.app.demos.base.BaseAuth; 
import com.app.demos.demo.DemoMap; 
import com.app.demos.demo.DemoWeb; 
import com.app.demos.model.Customer; 
import com.app.demos.test.TestUi; 
import com.app.demos.ui.UiBlogs; 
import com.app.demos.ui.UiConfig; 
import com.app.demos.ui.UiIndex; 
import com.app.demos.ui.UiLogin; 
import android.app.AlertDialog; 
import android.os.Bundle; 
import android.view.Menu; 
import android.view.Menultem; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.ImageButton; 
public class BaseUiAuth extends BaseUi { 
private final int MENU APP WRITE = 0; 
private final int MENU APP LOGOUT - 1; 
private final int MENU APP ABOUT = 2; 
private final int MENU DEMO WEB = 3; 
private final int MENU DEMO MAP - 4; 
private final int MENU DEMO TEST = 5; 
protected static Customer customer = 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
if (!BaseAuth.isLogin()) ( 
this. forward (UiLogin.class) ; 
this.onStop () 7 
} else { 
customer = BaseAuth.getCustomer () ; 


null; 


} 
} 
GOverride 
public void onStart() { 
super.onStart (); 
this.bindMainTop(); 
this.bindMainTab(); 
š 
GOverride 
public boolean onCreateOptionsMenu (Menu menu) { 
super.onCreateOptionsMenu (menu); 
menu.add(0, MENU APP WRITE, 0, R.string.menu app write) .setIcon (android. 
R.drawable.ic menu add); ulis 
menu.add(0, MENU APP LOGOUT, 0, R.string.menu app logout) .setIcon (android. 
R.drawable.ic menu close clear cancel); 
menu.add(0, MENU APP ABOUT, 0, R.string.menu app about) .setIcon (android. 
R.drawable.ic menu info details); 
menu.add(0, MENU DEMO WEB, 0, R.string.menu demo web) .setIcon (android. 
R.drawable.ic menu view); 
menu.add(0, MENU DEMO MAP, 0, R.string.menu demo map) .setIcon (android. 
R.drawable.ic menu view); 
menu.add(0, MENU DEMO TEST, 0, R.string.menu demo test) .setIcon (android. 
R.drawable.ic menu view); E 
return true; 
} 
GOverride 
public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId()) { 
case MENU APP WRITE: { 
doEditBlog(); 
break; 
} 
Case MENU APP LOGOUT: { 
doLogout(); // do logout first 
forward (UiLogin.class) ; 
break; 
š 
case MENU APP ABOUT: 
AlertDialog.Builder builder - new AlertDialog.Builder (this); 
builder.setTitle(R.string.menu app about); 
String appName = this.getString(R.string.app name); 
String appVersion - this.getString(R.string.app version); 


builder.setMessage (appName + " " + appVersion); 
builder.setIcon (R.drawable.face); 
builder.setPositiveButton (R.string.btn cancel, null); 
builder.show(); T 


break; 

case MENU DEMO WEB: 
forward (DemoWeb.class); 
break; 

case MENU DEMO MAP: 


forward (DermoMap class) ; 
break; 

case MENU_DEMO_TEST: 
forward (TestUi.class) ; 
break; 


return super.onOptionsItemSelected (item) ; 
} 
private void bindMainTop () { 
Button bTopQuit = (Button) findViewById(R.id.main top quit); 
if (bTopQuit !- null) ( li 
OnClickListener mOnClickListener = new OnClickListener() ( 
GOverride 
public void onClick(View v) ( 
switch (v.getId()) { 
case R.id.main top quit: 
doFinish(); 
break; 
} 
} 


H 
bTopQuit.setOnClickListener (mOnClickListener); 
} 
private void bindMainTab () 
ImageButton bTabHome = (ImageButton) findViewById(R.id.main tab 1 
ImageButton bTabBlog = (ImageButton) findViewById(R.id.main tab 2) 
ImageButton bTabConf = (ImageButton) findViewById(R.id.main tab 3); 
ImageButton bTabWrite = (ImageButton) findViewById(R.id.main tab 4); 
if (bTabHome != null && bTabBlog != null && bTabConf != null) ( ` 
OnClickListener mOnClickListener = new OnClickListener() { 
GOverride 
public void onClick(View v) ( 
switch (v.getId()) ( 
case R.id.main tab 1: 
forward (Uilndex.class); 
break; 
case R.id.main tab 2: 
forward (UiBlogs.class) ; 
break; 
case R.id.main tab 3: 
forward (UiConfig.class) ; 
break; 
case R.id.main tab 4: 
doEditBlog(); 
break; 


} 
H 
bTabHome.setOnClickListener (mOnClickListener); 
bTabBlog.setOnClickListener (mOnClickListener); 
bTabConf.setOnClickListener (mOnClickListener); 
bTabWrite.setOnClickListener (mOnClickListener); 


下 面 简要 分 析 一 下 BaseUiAuth 类 中 的 重点 方法 与 逻辑 。 


1.onCreate 与 onStart 方 法 


这 两 个 生命 周期 方法 中 所 放 的 都 是 界面 初始 化 时 的 逻辑 。onCreate 方 法 中 加 入 了 验证 用 户 是 否 登录 的 逻辑 ， 如 果 验 证 失败 就 会 返回 用 户 登 录 页 面 ; 而 onStart 方 法 中 则 执行 了 bindMainTop 与 
bindMainTab 两 个 方法 ， 即 界面 顶部 导航 栏 和 底部 选项 按钮 的 相关 逻辑 。 


2.onCreateOptionsMenu 方 法 


选项 菜单 的 初始 化 方法 ， 此 处 使 用 Menu 对 象 的 add 方 法 添加 了 6 个 菜单 项 ， 需 要 注意 的 是 ， 这 些 菜单 的 ID 都 是 在 BaseUiAuth 类 的 属性 中 定义 的 。 至 于 这 些 菜单 选项 的 详细 情况 请 参考 7.5.2 节 中 的 内 


3.0nOptionsltemSelected 方 法 


选项 菜单 的 逻辑 实现 ， 按 照 菜单 ID 来 分 别 实现 每 个 菜单 选项 的 逻辑 ， 比 如 ， 写 微 博 选项 (IDAMENU_APP_WRITE) 是 使 用 doEditBlog 方 法 来 实现 的 ， 而 用 户 注销 选项 (ID 为 MENU_APP_LOGOUT) 
则 调用 了 doLogout 方 法 等 。 这 些 功能 逻辑 中 的 绝 大 部 分 的 使 用 方法 在 BaseUi 界 面 基 类 中 都 能 找到 ， 唯 一 特殊 的 是 应 用 信息 选项 (ID 为 MENU_APP_ABOUT) 的 处 理 罗 辑 ， 有 关内 容 我 们 会 在 下 面 的 7.5.3 节 


中 详细 介绍 。 


4.bindMainTop 与 bindMainTab 方 法 


bindMainTop 方 法 是 对 界面 框架 顶部 导航 栏 中 退出 按钮 的 逻辑 实现 ， 处 理 该 按钮 的 点 击 事件 使 用 到 了 OnClickListener 监 听 器 ， 实 现 逻 辑 相 对 比较 简单 ， 就 是 调用 doFinish 方 法 结束 当前 界面 。 
bindMainTab 则 是 对 底部 4 个 功能 选项 按钮 的 逻辑 实现 ， 这 里 同样 使 用 和 了 OnClickListener 监 听 器 ， 逻 辑 也 相对 比较 简单 ， 都 是 一 些 基 本 的 界面 切换 方法 的 调用 ; 不 过 我 们 需要 注意 的 是 ， 所 有 底部 选项 的 
按钮 控件 都 在 使 用 同一 个 监听 器 类 ， 这 种 简化 代码 的 写法 在 多 个 UI 控件 共用 同一 种 事件 的 时 候 经 常用 到 。 


75.2 全 局 Menu 菜 单 


学 习 Android 开 发 基础 时 ， 我 们 已 经 简单 介绍 过 Menu 菜 单 控件 的 大 致 分 类 与 基本 使 用 ， 如 有 遗忘 请 参考 2.7.4 节 中 内 容 。 对 于 微 博 应 用 来 说 ， 其 中 最 主要 的 菜单 就 是 选项 菜单 ， 即 Options Menu, 无 
论 在 哪个 登录 之 后 的 界面 中 只 要 按 下 设备 的 菜单 按钮 ， 微 博 应 用 的 选项 菜单 都 会 出 现在 系统 底部 。 效 果 如 图 7-13 所 示 。 
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图 7-13 ”选项 菜单 效果 


从 图 7-13 中 可 以 看 出 ， 微 博 应 用 的 选项 菜单 有 6 个 ， 现 说 明 如 下 。 


BAR: 打开 微 博 撰写 界面 ， 详 情 请 参考 7.9.4 节 。 
* 注销 账户 : 注销 当前 登录 用 户 ， 退 回 到 用 户 登录 界面 。 


. 应 用 信息 : 查看 微 博 应 用 的 说 明 信 息 ， 详 情 请 参考 7.5.3 节 。 


: 网 页 示例 : 切换 至 网 页 版 示例 界面 ， 详 情 请 参考 7.11.2 节 。 


“ 地 图 示例 : 切换 至 网 页 地 图 示例 界面 ， 详 情 请 参考 7.11.5 节 。 


测试 示例 : 切换 至 客户 端 性 能 测试 界面 ， 详 情 请 参考 8.1.2 节 。 


至 于 菜单 的 实现 逻辑 ， 我 们 在 前 面 讲解 BaseUiAuth 类 的 时 候 已 经 介绍 过 了 ， 可 参考 7.5.1 节 中 与 代码 清单 7-47 的 相关 内 容 。 


7.5.3 全 局 Dialog 窗 口 


常见 的 Android 对 话 框 控 件 (Dialog) 的 概念 和 用 法 在 2.7.6 节 中 已 经 介绍 过 了 。 实 际 上 ， 微 博客 户 端 程序 框架 也 为 我 们 提供 了 便捷 的 基础 对 话 框 类 ， 也 就 是 com.app.demos.dialog 类 包 中 的 
BasicDialog 类 ， 比 如 在 上 节 中 刚 介绍 的 微 博 应 用 选项 菜单 中 的 应 用 信息 选项 就 是 使 用 该 类 来 实现 的 ， 运 行 效果 如 图 7-14 所 示 。 
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下 面 我 们 来 学 习 一 下 BasicDialog 类 的 代码 实现 ， 见 代码 清单 7-48。 


代码 清单 7-48 


package com.app.demos.dialog; 
import com.app.demos.R; 
import android.app.Dialog; 
import android.content.Context; 
import android.os.Bundle; 
import android.view.ViewGroup; 
import android.view.Window; 
import android. view.WindowManager; 
import android.widget.TextView; 
public class BasicDialog { 
private Dialog mDialog; 
private TextView mTextMessage; 
public BasicDialog(Context context, Bundle params) { 
// 初始 化 对 话 框 


图 7-14 ”BasicDialog 对 话 框 效果 


mDialog = new Dialog (context, R.style.com app weibo theme dialog); 


mDialog.setContentView(R.layout.main dialog); 

mDialog.setFeatureDrawableAlpha (Window.FEATURE OPTIONS PANEL, 

// 设置 显示 位 置 

Window window = mDialog.getWindow(); 

WindowManager.LayoutParams wl = window.getAttributes (); 

wl.x = 0; 

wl.y = 0; 

window.setAttributes (wl); 

window.setFlags (WindowManager.LayoutParams.FLAG FULLSCREEN, 
WindowManager.LayoutParams.FLAG FORCE NOT FULLSCREEN); B 

window.setLayout (200, ViewGroup.LayoutParams.WRAP CONTENT); 

// 设置 显示 文本 


mTextMessage = 


0); 


(TextView) mDialog.findViewById(R.id.cs main dialog text); 


mTextMessage.setTextColor (context .getResources () .getColor (R.color.gray) ); 


mTextMessage.setText (params.getString("text")); 
} 
Public void show() { 
mDialog.show() 


} 


BaseDialog 类 并 没有 使 用 现成 的 AlertDialog 或 者 ProgressDialog 等 对 话 框 类 ， 而 是 扩展 自 最 基础 的 Dialog 对 话 框 类 ， 这 样 做 的 好 处 是 获得 最 大 的 自 定义 权限 。 这 里 的 对 话 框 就 使 用 了 自 定义 的 样式 模 
板 ， 即 R.layout.main_dialog 对 应 的 main_dialog.xml 文 件 ， 实 际 上 所 有 的 对 话 框 控 件 都 可 以 使 用 setContentView 来 设置 自 定义 的 模板 。 此 外 ，main_dialog.xml 模 板 文 件 非常 简单 ， 里 面 就 包含 了 一 个 ID 
为 cs main_dialog_text 的 文本 框 控 件 ， 后 面 程序 在 设置 对 话 框 文字 的 时 候 使 用 的 就 是 这 个 控件 。 最 后 ， 我 们 还 需要 注意 如 何 获取 Dialog 的 Window 对 象 来 设置 窗口 的 显示 位 置 ， 从 代码 中 可 以 看 出 


BaseDialog 被 设置 在 屏幕 的 中 间 位 置 。 


使 
们 还 可 以 使 


时 ， 我 们 只 需 


754 使 用 Service 获 取 通 知 


在 微 博 应 用 的 功能 模块 设计 (04.315) 中 我 们 曾经 提 到 “即时 消息 提醒 ”的 功能 ， 
知 ， 而 微 博客 户 端 则 需要 启动 对 应 的 Service 服 务 来 定时 从 该 API 接 


通过 对 2.4.2 节 的 学 习 ， 我 们 了 解 了 Android 
务 ， 逻 辑 可 参考 界面 控制 器 类 UiLogin ( 见 代码 清单 7-20) 的 onTas 


在 微 博 


9 大 组 件 之 一 的 Service 组 件 的 概念 和 作用 ， 用 其 实现 即时 通知 功能 是 
Complete 方 法 中 的 成 功 登 录 之 后 的 逻辑 ， 准 确 来 说 就 是 以 下 这 行 代码 。 


肛 务 端的 程序 开发 介绍 中 ， 也 介绍 了 获取 通知 接 
获取 通知 信息 并 进行 消息 提示 ， 这 就 是 本 节 需 要 重点 介绍 的 NoticeService 


Bundle 对 象 传 入 信息 到 BaseDialog 的 构造 方法 中 并 执行 该 类 的 show 方 法 即 可 ; 在 BaseUi 类 中 还 提供 了 更 简单 的 openDialog 方 法 来 调用 BaseDialog 自 定义 窗口 控件 。 当 然 ， 我 
与 BaseDialog 类 似 的 思路 构造 出 各 种 各 样 的 Dialog 窗 口 类 ， 存 放 到 对 应 的 com.demos.app.dialog 类 包 下 ， 扩 展 微 博客 户 端 框架 的 内 容 。 


会 提供 微 博 系统 的 即时 通 


的 内 容 ( 见 6.7 节 ) , RAPHE 
及 务 的 实现 。 


合适 不 过 了 。 在 微 博 应 用 中 ， 当 用 户 成 功 登录 之 后 ， 程 序 就 会 启动 NoticeService 服 


BaseService.start (this, NoticeService.class) ; 


以 上 代码 虽然 简 
NoticeService， 也 就 是 获取 即时 通知 的 Service 类 ,位 于 com.app.demos.service 包 下 。 


下 面 我 们 来 分 析 BaseService 类 主要 功能 逻辑 的 实现 ， 如 代码 清单 7-49 所 示 。 


代码 清单 7-49 


， 但 是 却 牵涉 两 个 重要 类 。 首 先是 BaseService， 该 类 是 微 博客 户 端 程序 框架 的 Service 服 务 基 类 ， 


于 创建 和 控制 Service 服 务 的 活动 ， 位 于 com.app.demos.base 包 下 ; 其 次 是 


package com.app.demos.base; 

import java.util.HashMap; 

import java.util.concurrent.ExecutorService; 

import java.util.concurrent.Executors; 

import com.app.demos.util.AppClient; 

import com.app.demos.util.AppUtil; 

import com.app.demos.util.HttpUtil; 

import android.app.Service; 

import android.content.Context; 

import android.content.Intent; 

import android.content.SharedPreferences; 

import android.content.SharedPreferences.Editor; 

import android.os.IBinder; 

public class BaseService extends Service { 
public static final String ACTION START = ".ACTION START"; 
public static final String ACTION STOP ACTION STOP"; 
public static final String ACTION PING ACTION PING"; 
public static final String HTTP TYPE - ".HTTP TYPE"; 
GOverride u B 
public IBinder onBind(Intent intent) ( 

return null; 


š 
GOverride 
public void onCreate() ( 
super.onCreate(); 
} 
GOverride 
public void onStart(Intent intent, int startId) { 
super.onStart(intent, startId); 
} 
public void doTaskAsync (final int taskId, final String taskUrl) { 
SharedPreferences sp = AppUtil.getSharedPreferences (this) ; 
final int httpType = sp.getInt (HTTP_TYPE, 0); 
ExecutorService es = Executors.newSingleThreadExecutor () ; 
es.execute (new Runnable () { 
GOverride 
public void run() ( 
try ( 
AppClient client - new AppClient (taskUrl); 
if (httpType == HttpUtil.WAP INT) { 
client.useWap(); 
} 


String httpResult = client.get(); 


onTaskComplete (taskId, AppUtil.getMessage (httpResult)); 


} catch (Exception e) { 
e.printStackTrace () ; 


l 


n; 
} 
public void doTaskAsync (final int taskId, final String taskUrl, final HashMap 
<String, String> taskArgs) { 
SharedPreferences sp = AppUtil.getSharedPreferences (this) ; 
final int httpType = sp.getInt (HTTP TYPE, 0); 
ExecutorService es = Executors .newSingleThreadExecutor () ; 
es .execute (new Runnable () { 
GOverride 
public void run() { 
try ( 
AppClient client - new AppClient (taskUrl); 
if (httpType == HttpUtil.WAP INT) { 
client.useWap(); ~ 
} 
String httpResult = client.post (taskArgs); 
onTaskComplete (taskId, AppUtil.getMessage (httpResult)); 
} catch (Exception e) { 
e.printStackTrace () ; 


) 


n; 
} 
public void onTaskComplete (int taskId, BaseMessage message) { 


} 
/////////////////////////////////////////////////////////////////////////// 
// 公 用 静态 方法 ， 供 外 部 类 使 用 
Public static void start (Context ctx, Class<? extends Service> sc) { 
// 获取 共享 数据 
SharedPreferences sp = AppUtil.getSharedPreferences (ctx) ; 
Editor editor = sp.edit(); 
editor.putInt(HTTP TYPE, HttpUtil.getNetType (ctx) ); 
editor.commit(); ` 
// 启动 Service 
String actionName = sc.getName() + ACTION_START; 
Intent i = new Intent (ctx, sc); 
i.setAction (actionName) ; 
ctx. startService (i); 
} 
public static void stop (Context ctx, Class<? extends Service» sc) { 
String actionName = sc.getName() + ACTION STOP; 
Intent i = new Intent(ctx, sc); i 
i.setAction (actionName) ; 
ctx. startService (i); 
} 
Public static void ping (Context ctx, Class<? extends Service> sc) { 
String actionName = sc.getName () + ACTION PING; 
Intent i = new Intent (ctx, sc); 
i.setAction (actionName) ; 
ctx.startService (i); 


BaseService 类 继承 自 Android Service 基 类 ， 封 装 了 Android 应 用 开发 中 使 用 Service 服 务 需要 用 到 


1.onCreate 和 onStart 方 法 


BaseService 类 的 初始 化 方法 和 开始 方法 中 没有 任何 的 逻辑 实现 ， 这 两 个 方法 用 于 提供 给 子 类 进行 重 


2.doTaskAsync 方 法 


的 基本 方法 ， 下 | 


我 们 来 分 析 该 类 的 主要 方法 。 


m 


发 起 异步 任务 方法 ， 主 


3.onTaskComplete 方 法 


5.stop 方 法 


线程 之 外 ， 不 能 共享 数据 ; 所 以 Service 和 


4.start 方 法 


实际 上 ， 在 7.3.1 节 中 介绍 使 有 


于 停止 Service 服 务 。 该 方法 逻辑 比较 简 重 


Tr 
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7.5.5 “使 用 Notification 显 示 通 知 


之 前 已 经 介绍 过 微 博 应 


代码 清单 7-50 


于 处 理 网 络 通信 ,与 BaseUi 类 中 doTaskAsyn< 方 法 的 用 法 类 似 。 在 NoticeService 类 中 ， 我 们 就 是 用 该 方法 从 服务 端 API 的 接口 中 获取 最 新 的 通知 信息 。 


于 异步 任务 的 结果 处 理 ， 与 BaseUi 类 中 onTaskComplete 方 法 的 用 法 类 似 。 使 用 范例 请 参考 NoticeService 类 中 onTaskComplete 方 法 中 的 代码 。 


于 启动 Service 服 务 。 值 得 注意 的 是 ， 这 里 我 们 使 用 HttpUtil 类 的 getNetType 方 法 ( 见 7.3.2 节 ) 获取 到 设备 的 联网 方式 ， 并 存储 到 系统 配置 SharedPreferences 存 储 空间 中 去 。 这 是 因为 Service 独 立 
线程 之 间 需 要 通过 其 他 方式 来 共享 数据 ， 而 SharedPreferences 就 是 一 个 不 错 的 选择 。 


AppClient 类 进行 网 络 通信 的 时 候 ， 我 们 就 把 BaseService 类 当做 网 络 通信 功能 的 使 


范例 来 介绍 ， 在 doTaskAsync 方 法 中 也 可 以 找到 AppClient 类 的 相关 代码 。 


所 有 Service 服 务 的 基 类 BaseService， 并 学 习 了 BaseService 类 的 基本 用 法 。 下 面 我 们 再 来 学 习 BaseService 的 使 用 范例 ， 也 就 是 其 子 类 ， 通 知 服务 类 NoticeService 的 代码 ， 如 
代码 清单 7-50 所 示 。 我 们 需要 关注 的 重点 在 于 ， 如 何 使 用 异步 任务 方法 (doTaskAsync 和 onTaskComplete) 来 获取 通知 信息 ， 并 使 用 Notification 组 件 把 通知 显示 册 


来 。 


Lr 


package com.app.demos.service; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


java.util.concurrent.ExecutorService; 
java.util.concurrent.Executors; 
com.app.demos.ui.UiBlogs; 
com.app.demos .base.BaseMessage; 
com.app.demos.base.BaseService; 
com.app.demos.base.C; 
com.app.demos.model.Notice; 
android.app.Notification; 
android.app.NotificationManager; 
android.app.PendingIntent; 
android.content.Intent; 
android.os.IBinder; 
class NoticeService extends BaseService { 
private static final int ID - 1000; 
private static final String NAME = NoticeService.class.getName|(); 
// Notification 消 息 管理 类 
private NotificationManager notiManager; 
// 线程 池 服 务 类 
private ExecutorService execService; 
// 循环 获取 通知 标记 
private boolean runLoop = true; 
GOverride 


public IBinder onBind(Intent intent) ( 


return super.onBind (intent); 


) 


GOverride 

public void onCreate() ( 
super.onCreate(); 
notiManager = ( 
execService = Executors.newSingleThreadExecutor (); 

} 

GOverride 

public void onStart(Intent intent, int startId) ( 
super.onStart (intent, startId); 
if (intent.getAction().equals (NAME + BaseService.ACTION START)) { 

startService(); B 

l 

} 

@Override 

public void onDestroy() { 
runLoop = false; 


} 


public void startService () { 
execService.execute (new Runnable () { 
GOverride 


public void run() { 
while (runLoop) { 

try ( 
// 从 服务 端 接口 获取 通知 
doTaskAsync (C.task.notice, C.api.notice); 
// 30 秒 后 再 循环 
Thread.sleep(30 * 10001); 

) catch (InterruptedException e) ( 
e.printStackTrace(); 


} 


n; 
} 
GOverride 
public void onTaskComplete (int taskId, BaseMessage message) ( 
try { 
Notice notice = (Notice) message.getResult ("Notice"); 
showNotification (notice.getMessage()); 
) catch (Exception e) ( 
e.printStackTrace(); 
l 
} 
private void showNotification (String text) ( 
try { 
Notification n = new Notification (); 
n.flags |= Notification.FLAG SHOW LIGHTS; 
n.flags |- Notification.FLAG AUTO CANCEL; 
n.defaults = Notification.DEFAULT ALL; 
n.icon = com.app.demos.R.drawable.icon; 
n.when = System.currentTimeMillis () ; 


// 设置 点 击 通知 后 需要 打开 的 UI 界面 


NotificationManager) getSystemService (NOTIFICATION SERVICE); 


PendingIntent pi = PendingIntent.getActivity(this, 0, new Intent (this, 


UiBlogs.class), 0); 
// 设置 通知 提示 
n.setLatestEventInfo(this, "demos Notice", text, pi); 
// 显示 通知 信息 
notiManager.notify(ID, n); 
} catch (Exception e) ( 
e.printStackTrace () ; 


} 


NoticeService 类 继承 自 BaseService (参考 7.5.4 节 ) ， 该 类 的 代码 比较 长 、 涉 及 的 知识 点 也 比较 多 ， 下 面 我 们 仅 对 其 


1.onCreate 和 onStart 方 法 


在 onCreate 方 法 中 ， 首 先 使 


2.startService 方 法 


启动 服务 时 ， 我 们 需要 使 用 育 


=l 


3.onTaskComplete 方 法 


由 于 获取 通知 接口 返回 的 是 唯一 的 Notice 对 象 ， 所 以 这 里 使 


4.showNotification 方 法 


该 方法 中 的 代码 实际 上 就 是 Notification 通 知 组 件 的 使 有 


中 比较 重 


的 逻辑 进行 剖析 和 归纳 。 


范例 ， 首 先 创建 Notification 对 象 并 对 其 属性 进行 初始 化 ， 然 后 调 


了 startService 方 法 ,3 


getSystemsService 方 法 获取 Android 系 统 通知 管理 者 类 NotificationManager 的 对 象 notiManager; 然后 使 
程 线程 池 对 象 execService， 分 别 用 于 Notification 通 知 的 处 理 和 新 线程 逻辑 的 创建 。 而 onStart 方 法 中 则 调 


面 准备 好 的 单线 程 线程 池 对 象 execService 来 启动 一 个 新 线程 ， 然 后 在 新 线程 中 使 用 doTaskAsync 方 法 循环 向 服务 端的 获取 通知 接口 
30 秒 请 求 一 次 ， 这 也 是 常见 的 HTTP 服 务 的 实现 方式 ， 如 果 要 做 到 实时 通知 ， 则 需要 通过 TCP 长 连接 来 实现 了 ， 这 涉及 java.net 类 包 中 Socket 类 的 使 


BaseMessage 的 getResult 方 法 就 可 以 直接 获取 到 Notice 通 知 对 象 ， 然 后 调 有 


m 


Executors 类 的 newSingleThreadExecutor 方 法 创建 了 


m 
E: 


要 包含 了 Service 启 动 时 需要 调用 的 逻辑 ， 下 面 会 马上 介绍 到 。 


( 见 6.7 节 ) 进行 请 求 ， 此 处 的 逻辑 是 
， 限 于 篇 幅 ， 下 面 不 再 做 深入 讨论 了 。 


showNotification 方 法 进行 展示 。 


BY 


准备 好 的 通知 管理 者 类 对 象 notiManager 的 notify 方 法 显示 通知 消息 。 


实际 上 ，NoticeService 服 务 会 在 登录 界面 的 逻辑 中 被 调用 ， 当 用 户 登 录 成 功 之 后 就 会 执行 “BaseService.start (this, NoticeService.class) ; ”这 行 代码 来 开启 通知 服务 ， 这 点 可 参考 代码 清单 7-20 


中 UiLogin 类 中 的 onTaskComplete 方 法 的 相关 逻辑 。 


另外 ,在 使 


Notification 的 时 候 要 注意 ，Notification 对 象 使 


: Notification.DEFAULT ALL: 所 有 配置 都 采用 默认 值 。 

: Notification.DEFAULT LIGHTS: 使 用 默认 通知 灯光 。 

: Notification.DEFAULT SOUND: 使 用 默认 通知 声音 。 

: Notification.DEFAULT VIBRATE: 使 用 默认 通知 振动 模式 。 

: Notification. FLAG AUTO CANCEL: 通知 点 击 后 自动 消失 。 

: Notification.FLAG INSISTENT: 让 声音、 振动 无 限 循环 ， 直 到 用 户 响应 。 
: Notification.FLAG_NO_CLEAR: 不 能 清除 该 通知 。 


Notification.FLAG_ONLY_ALERT_ONCE: 通知 仅 提 示 一 次 。 


直接 给 属性 赋值 的 方式 来 进行 配置 ， 这 点 和 其 他 的 组 件 是 不 太 相同 的 。 这 里 把 常 


的 配置 常量 总 结 如 下 。 


: Notification.FLAG SHOW LIGHTS: 采用 自 定义 灯光 ， 可 通过 设置 public 成 员 变量 来 实现 ，ledARGB 表 示 灯 光 颜 色 、ledOnMS 亮 持续 时 间 、ledOfftMS 瞳 的 时 间 。 


: Notification.STREAM_DEFAULT: 通知 声音 的 来 源 ， 默 认 值 是 STREAM_RING， 即 铃声 。 


最 后 ，NotificationManager 是 Android 系 统 的 通知 服务 ， 用 于 管理 所 有 的 通知 消息 ， 


有 通知 。 
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由 


点 关注 三 个 方法 : notify 方 法 用 于 发 起 一 个 通知 ，cance| 方 法 用 于 清除 对 应 ID 的 通知 ，cancelAll 则 用 于 移 除 所 


通过 本 章 前 半 部 分 内 容 的 学 习 ， 我 们 已 经 掌握 了 构建 微 博 应 用 客户 端 程序 的 主要 模块 和 类 库 的 使 用 ， 从 本 节 开 始 ， 将 对 微 博 应 用 主要 界面 的 代码 逻辑 和 界面 组 成 做 细致 的 剖析 。 大 家 既 可 以 把 每 个 小 节 
的 内 容 当做 不 同 的 实例 分 开 阅 读 ， 又 可 以 把 所 有 实例 组 合成 一 个 完整 的 微 博 应 用 项 目 来 学 习 。 


在 用 户 登 录 界 面 中 ， 我 们 将 学 习 到 Android 应 


另外 ， 我 们 还 会 学 到 一 些 辅助 图 形 组 件 (Shape) 的 


7.6.1 ”界面 程序 逻辑 


框架 中 基本 表单 控件 的 用 法 ， 包 括 文本 框 控件 (TextView) 、 输 入 框 控件 (EditText) 、 复 选 框 控 件 (CheckBox) 以 及 按钮 控件 (Button) 的 用 法 。 


法 以 及 应 用 配置 存储 方案 的 应 用 。 


户 登录 界面 的 控制 器 类 UiLogin 在 本 章 之 前 的 内 容 中 已 经 接触 得 很 多 了 ， 该 类 的 代码 逻辑 在 7.1.3 节 中 也 已 经 给 大 家 详细 介绍 过 ， 这 里 不 再 歼 述 。 不 过 在 本 节 中 ， 我 们 将 从 另 一 个 角度 ， 也 就 是 界面 U1 


实现 的 角度 ， 来 介绍 在 登录 界面 的 开发 过 程 中 所 用 到 的 Android UI 控件 的 概念 和 用 法 。 另 外 ， 在 接 下 来 的 几 个 小 节 中 ， 我 们 将 对 微 博 实例 应 用 中 所 要 用 到 的 主要 UI 控件 进行 逐个 介绍 。 


7.6.2 使 用 TextView 


TextView 即 文本 框 控 件 ， 用 于 文本 显示 ， 该 控件 不 支持 编辑 ， 如 果 需 要 编辑 请 使 用 EditText， 参 考 7.6.3 节 内 容 。TextView 类 位 于 android.widget 包 下 ， 继 承 自 View， 下 面 是 TextView 类 的 继承 关系 。 


java.lang.Object 
|- android.view.View 
|- android.widget.TextView 


TextView 继 承 了 View 的 所 有 属性 ， 除 了 通用 属性 (参考 2.7.1 节 ) 之 外 ，TextView 还 具有 自己 特有 的 控件 属性 ， 我 们 把 其 中 常用 属性 的 用 法 总 结 到 表 7-2 中 。 当 然 ， 在 界面 控制 器 中 ，UI 控 件 还 可 以 通 


过 程序 来 操作 ， 与 属性 对 应 的 属性 方法 就 是 用 于 控制 相关 属性 的 。 


表 7-2 TextView 控 件 常 用 属性 


属性 名 操作 方法 使 用 说 明 
android:autoLink setAutoLinkMask(int) 文本 含有 URL/ 邮件 /电话 等 关键 词 时 ， 是 否 显 示 可 点 


击 链接 ， 可 选 值 有 none/web/mail/phone/map/all 


android:lines setLines(int) 显示 文本 行 数 ， 设 置 几 行 就 显示 几 行 ， 即 使 没有 数据 
android:maxLines setMaxLines(int) 显示 最 大 行 数 ， 通 常 与 width gk layout width 配合 使 
HW, 超出 宽度 可 自动 换行 ， 超 出 行 数 将 不 显示 
android:text setText(CharSequence. 设置 文本 内 容 
TextView.BufferType) 
android:textAppearance 无 设置 文本 样式 ， 可 使 用 theme 样式 
android:textColor setTextColor(int) 设置 字体 颜色 ， 如 白色 “#ffffff” 
android:textColorLink setLinkTextColor(int) 设置 链接 颜色 
android:textSize setTextSize(int.float) 设置 文字 大 小 ， 以 sp 或 dip 为 单位 
android:textStyle setTypeface(Typeface) 设置 字体 样式 ， 可 选 值 有 bold/italic/bolditalic 


登录 界面 中 使 用 到 的 TextView 控 件 有 3 个 ， 包 括 顶 部 的 “用 户 登录 ”文字 ,以 及 “账户 ”与 “密码 ”输入 框 左边 的 文字 ， 代 码 清单 7-51 就 是 从 登录 界面 的 模板 文件 ui_login.xml 中 截取 的 示例 代码 ， 该 文 


件 的 完整 版 请 参考 代码 清单 7-21。 


代码 清单 7-51 


<TextView 
android:layout width-"wrap content" 


android: textAppearance="?android:attr/textAppearanceLarge" 


android:layout height-"wrap content" 


android:layout gravity-"center horizontal" 


android:text-"üstring/login title" 
android:layout margin-"20dip" 
android:textSize-"l0pt"/» 


从 以 上 代码 可 以 看 出 ， 我 们 使 用 android: layout width, android: layout_height 等 通用 属性 来 控制 TextView 控 件 外 观 ， 用 android: text 属 性 来 设置 文字 ， 用 android: textSize 属 性 来 设置 字体 大 
小 ,还 用 android: textAppearance 属 性 来 设置 文字 的 样式 。 


7.6.3 ”使 用 EditText 


EditText 即 输入 框 控 件 ， 用 于 文本 输入 ，EditText 类 位 于 android.widget 包 下 ， 继 承 自 TextView， 下 面 是 EditText 类 的 继承 关系 。 


java.lang.Object 
|- android.view.View 
|- android.widget.TextView 
|- android.widget.EditText 


EditText 继 承 了 View 和 TextView 的 所 有 属性 ， 我 们 把 EditText 控 件 特有 属性 的 使 用 方法 以 及 属性 对 应 的 操作 方法 总 结 在 表 7-3 中 。 


表 7-3 EditText 控 件 常用 属性 


属性 名 操作 方法 


使 用 说 明 


默认 提示 文字 


设置 只 能 接受 


android:hint setHint(int) 


X. EL ^X B 


设置 可 输入 的 : 


LX PL 


android:digits setKeyListener(KeyListener) 


android:maxLength setFilters(InputFilter) 


android:numeric setKeyListener(KeyListener) 


无 密码 输入 模式 ， 


android:password 


Z Des y: 
字数 

只 接受 数字 输入 ， 

保护 输入 内 容 


可 与 android:digits 配合 使 用 


登录 界面 中 ， 有 两 个 输入 框 控件 ， 即 账 


户 和 密码 输入 框 的 EditText 控 件 ，ui_login.xml 模 板 文件 中 与 输入 框 控 件 元 素 有 关 的 声明 如 代码 清 


代码 清单 7-52 


<EditText 
android: layout_weight="1" 
android: layout_widt ill parent" 
android:layout height-"wrap content" 
android:id-"8«id/app login edit name" 
android:layout _marginLeft="60dip"/> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
<EditText 
android: 
android: 
android: 
android: 
android: 
android: 


layout_weight="1" 


layout widt] ill parent" 
layout height-"wrap content" 
inputType-"textPassword" 
id-"(4id/app login edit pass" 
layout marginLeft-"60dip"/» 


从 上 面 的 模板 代码 中 可 以 看 出 ， 
指定 控件 的 唯一 标识 。 
清单 7-53。 


两 个 EditText 中 控件 属性 的 
一 般 来 阅 ， 如 果 我 们 需要 在 程序 中 获得 指定 控件 的 对 象 ， 就 需要 


到 android: id 


代码 清单 7-53 


法 没有 特别 的 地 方 ， 和 之 前 介绍 的 TextView 控 件 对 比 ， 只 不 过 增加 了 一 个 android: id 


单 7-52 所 示 。 


BE, 


该 属性 类 似 于 HTML 元 素 的 id 属性 ， 是 模板 中 


属性 。 比 如 ，UiLogin 类 的 程序 逻辑 中 就 有 获取 账户 和 密码 输入 框 控 件 输入 信息 的 代码 示例 ， 见 代码 


public class UiLogin extends BaseUi { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
private EditText mEditName; T 
private EditText mEditPass; 
public void onCreate (Bundle savedInstanceState) { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
mEditName = (EditText) this.findViewById(R.id.app login edit name); 
mEditPass = (EditText) this.findViewById(R.id.app login edit pass); 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
} 
Private void doTaskLogin() { 
app.setLong (System. currentTimeMillis()); 
if (mEditName.length() > 0 && mEditPass.length() > 0) { 
HashMap<String, String> urlParams = new HashMap<String, String>(); 
urlParams.put ("name", mEditName.getText () .toString()); 
urlParams.put ("pass", mEditPass.getText () .toString()); 
try { 
this.doTaskAsync(C.task.login, C.api.login, urlParams) ; 
} catch (Exception e) { 
e.printStackTrace () ; 
} 
} 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


以 上 代码 逻辑 截取 自 UiLogin 类 ， 在 onCreate 初 始 化 方法 中 使 


findViewByld 获 取 账 户 和 密码 输入 框 的 EditText 对 象 ， 然 后 在 异步 任务 执行 方法 doTaskLogin 中 使 


EditText 对 象 的 getText 方 法 获取 用 


户 输入 信息 并 发 送 给 服务 端 API。 当 然 ， 与 getText 方 法 对 应 的 还 有 setText 方 法 ， 即 


7.6.4 使 用 Button 


Button 即 按钮 控件 ， 主 要 | 


于 响应 


java.lang.Object 
|- android.view.View 
|- android.widget.TextView 
|- android.widget.Button 


于 设置 输入 框 控件 文字 信息 的 方法 ， 有 了 这 两 个 方法 ， 大 家 就 可 以 很 方便 地 操控 输入 框 控件 来 为 我 所 用 。 


户 的 点 击 动作 ，Button 类 位 于 android.widget 包 下 ， 继 承 自 TextView， 下 面 是 Button 类 的 继承 关系 。 


Button 继 承 了 View 和 TextView 的 所 有 属性 ， 我 们 从 2.7.1 节 所 介绍 的 通用 属性 和 表 7-2 的 属性 列表 中 可 以 看 到 Button 控 件 大 部 分 的 
OnClickListener 事 件 的 响应 方法 。 在 ui_login.xml 中 ， 登 录 按钮 的 控件 元 素 声明 如 代码 清单 7-54 所 示 。 


代码 清单 7-54 


属性 用 法 。 对 于 Button 控 件 来 说 ， 我 们 更 需 


注意 的 是 控件 


<Button 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/app_login_btn_submit" 
layout_height="wrap_content" 
text="@string/login_submit" 
layout_width="100dip" 
layout_alignParentRight="true" 
layout_centerVertical="true"/> 


登录 按钮 控件 的 属性 设置 并 不 复杂 ， 大 部 分 属性 的 用 法 我 们 都 遇 到 过 
中 。UiLogin 中 与 该 按钮 控件 相关 的 逻辑 如 代码 清单 7-55 所 示 。 


， 不 过 还 是 有 两 个 新 属性 需要 提 及 ，android : 


代码 清单 7-55 


public class UiLogin extends BaseUi { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void onCreate (Bundle savedInstanceState) { T 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
OnClickListener mOnClickListener = new OnClickListener() ( Bai 
GOverride 
public void onClick(View v) { 


layout alignParentRight 即 靠 右 显 示 ，android : 


= 


layout_centerVertical 即 垂 


lii) 


i 


switch (v.getId()) { 
case R.id.app login btn submit : 
doTaskLogin(); ` 
break; 


$ 


findViewById(R.id.app login btn submit) .setOnClickListener (mOnClickListener) ; 


} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


ALIS, BATS ibe SPR RRA SO TIR Ei aS 


7.6.5 ”使 用 Shape 和 Selector 


Android 系 统 中 不 仅 可 以 使 


IR] 


像 作为 Drawable 资 源 ， 还 可 以 使 用 系统 内 置 的 


D 


形容 器 的 泻 染 选项 ， 常 


的 泻 染 选 项 标签 有 渐变 泻 染 标签 gradient、 大 小 标签 size， 描 边 标签 stroke 以 及 


形 组 件 Shape 来 实现 比较 简单 的 几何 图 形 和 渐变 效果 。 我 们 可 以 把 Shape 看 做 是 一 个 图 形 的 容器 ， 其 内 部 标签 则 是 该 图 


角 标 签 corners 等 。 


就 以 登录 界面 为 例 ， 


示 。 


代码 清单 7-56 


界面 背景 使 


的 是 @drawable/xml_login_bg 资 源 ， 而 这 个 资源 就 是 使 


件 监听 器 的 代码 写法 ， 在 OnClickListener 监 听 器 类 的 onClick 方 法 中 执行 了 doTaskLogin 方 法 。 


Shape 组 件 来 实现 的 ， 代 码 可 参考 res/drawable/ 目 录 下 的 xml_login_bg.xml 文 件 ， 如 代码 清单 7-56 所 


<?xml version-"1.0" encoding-"utf-8"?» 
«shape xmins:android-"http://schemas.android.com/apk/res/android"» 


«gradient 


android: startColor="@color/bg" 
android: centerColor="@color/white" 
android: endColor="@color/bg" 
android: angle="270" 
android:centerY="0.3" /> 

<corners android:radius="0dip" /> 


</shape> 


可 以 看 到 shape 标 签 内 部 还 谋 套 了 渐变 泻 染 标签 gradient， 该 标签 就 是 


中 、 下 三 部 分 的 背景 色 ， 


除 Shape 之 外 ， 我 们 
state_selected 以 及 获得 焦点 状态 android: state focused 等 。 登 录 界 面 中 我 们 也 运 


于 渐变 演 染 的 ， 这 里 我 们 使 


再 介绍 一 个 常 


的 UI 组 件 ， 那 就 是 


于 选择 按钮 效果 的 Selector 组 件 ， 该 组 件 


了 android: startColor, android: centerColor 和 android: endColor 来 分 别 设置 医 
以 及 渐变 的 角度 (android: angle) 与 垂直 位 置 (android: centerY) ， 最 终 效果 就 是 登录 界面 的 运行 效果 ， 如 图 7-2 所 示 。 


形 的 上 、 


设置 按钮 的 各 个 状态 ， 包 括 被 点 击 状态 android: state_pressed、 被 选中 状态 android : 


状态 和 按 下 状态 的 背景 医 


代码 清单 7-57 


。 然 后 准备 好 xml_login_btn.xm| 资 源 模板 文件 ， 如 代码 清单 7-57 所 示 。 


了 该 组 件 来 美化 登录 按钮 的 效果 。 首 先 ， 我 们 准备 了 两 张 图片 ，button_1.png 和 button_2.png 分 别 作 为 登录 按钮 正常 


<?xml version-"1.0" encoding-"utf-8"?» 
«selector xmlns:android-"http://schemas.android.com/apk/res/android"» 


<!-- focused effect --» 

<item android:state focused-"true" android:drawable="@drawable/button_2" /> 
<!-- pressed effect --» T 
<item android:state pressed="true" android:drawable="@drawable/button_2" /> 
<!-- selected effect --> 


<item android:state selected-"true" android:drawable="@drawable/button_2" /> 
<!-- default effect --» 
<item android:drawable="@drawable/button_1" /> 


</selector> 


上 述 代 码 中 ， 我 们 可 以 看 到 该 按钮 在 被 点 击 、 被 选中 以 及 获得 仿 


登录 按钮 控件 做 如 下 替换 ， 见 代码 清单 7-58。 


代码 清单 7-58 


点 等 几 种 状态 下 的 设置 ; 当然 ， 对 于 按钮 控件 来 说 ， 这 里 起 作 


的 可 能 只 有 被 点 击 状态 的 设置 。 最 后 ， 把 登录 界面 模板 ui login.xml 中 的 


<LinearLayout http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
<RelativeLayout http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
<!-- <Button 


android: id="@+id/app login btn submit" 

android:layout height-"wrap content" 
id:text="@string/login_ submit" 

ayout width-"100dip" 

layout alignParentRight-"true" 


android:layout centerVertical-"true"/» --» 
«Button T 
android:id="@+id/app_login btn submit" 
android: text="@string/login_submit" 
android: layout_width="90dip" 
android: layout_height="35dip" 
android: layout_alignParentRight="true" 
android: layout_centerVertical="true" 
android: focusable="true" 
android:background="@drawable/xml_login_btn"/> 
</RelativeLayout> T B 
</LinearLayout> 


以 上 代码 我 们 更 换 了 Button 控 件 的 配置 代码 ， 设 置 背景 属性 为 @drawable/xml login btn, 


即 前 面 准备 好 的 xml_login_btn.xml 资 源 模板 ， 


新 编译 执行 即 可 。 登 录 按 钮 的 前 后 对 比如 图 7-15 所 示 。 


由 


图 7-15 ”登录 按钮 前 后 对 比 


IR] 


从 图 7-15 中 可 以 看 出 ， 优 化 后 的 登录 按钮 变 得 更 加 美观 了 ; 此外， 按钮 点 击 的 时 候 会 有 按 下 的 效果 。 在 实际 项 目 中 ，Shape 和 Selector 组 件 的 使 用 是 非常 广泛 的 ; 另外 ， 这 种 使 用 系统 原生 UI 组 件 泻 染 
形 的 方式 通常 比 使 用 图 片 资源 的 方式 更 有 效率 。 因 此 ， 在 Android 应 用 开发 中 我 们 要 尽量 多 使 用 这 些 系统 原生 的 UI 组 件 。 


[ 


[I 


7.6.6 ”使 用 CheckBox 


CheckBox 即 复 选 框 控件 ， 用 于 处 理 多 个 选项 的 选择 动作 ，CheckBox 类 位 于 android.widget 包 下 ， 继 承 自 Button， 下 面 是 类 包 的 层次 。 


java.lang.Object 
|- android.view.View 
|- android.widget.TextView 
|- android.widget.Button 
|- android.widget.CompoundButton 
|- android.widget.CheckBox 


CheckBox 继 承 了 View 和 Button 的 所 有 属性 ， 相 对 于 控件 属性 的 使 用 ， 我 们 更 需要 关注 的 是 如 何 使 用 sChecked 和 setChecked 方 法 来 控制 复 选 框 控 件 的 选择 和 未 选择 状态 。 在 微 博 登录 界面 中 ， 我 们 使 
选 框 控件 来 处 理 记 住 密码 的 逻辑 。 我 们 把 这 部 分 代码 抽取 出 来 做 详细 分 析 ， 如 代码 清单 7-59 所 示 。 


代码 清单 7-59 


public class UiLogin extends BaseUi { 
private EditText mEditName; 
private EditText mEditPass; 
private CheckBox mCheckBox; 
private SharedPreferences settings; 
public void onCreate (Bundle savedInstanceState) { 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
mEditName (EditText) this.findViewById(R.id.app login edit name) PO 
mEditPass (EditText) this.findViewById(R.id.app login edit pass); 
mCheckBox (CheckBox) this.findViewById(R.id.app login check remember); 
// 获取 记 住 的 账号 和 密码 
settings = getPreferences (Context .MODE PRIVATE); 
if (settings.getBoolean ("remember", false)) ( 
mCheckBox. setChecked (true) ; 
mEditName.setText (settings.getString("username", "")); 


mEditPass.setText (settings.getString("password", "")); 


mCheckBox.setOnCheckedChangelistener (new CheckBox.OnCheckedChangeListener () ( 
GOverride 
public void onCheckedChanged (CompoundButton buttonView, boolean isChecked) ( 
SharedPreferences.Editor editor = settings.edit(); 
if (mCheckBox.isChecked()) ( 
editor.putBoolean ("remember", true); 
editor.putString("username", mEditName.getText ().toString()); 
editor.putString("password", mEditPass.getText () .toString()); 
} else { 


editor.putBoolean("remember", false); 
editor.putString("username", ""); 
editor.putString("password", ""); 


editor.commit (); 
} 
n; 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
l 


记 住 密码 逻辑 涉及 账户 名 输入 框 控 件 mEditName、 密 码 输 入 框 控件 mEditPass 和 记 住 密码 复 选 框 控 件 对 象 mCheckBox， 当 用 户 点 击 记 住 密码 复 选 框 控 件 时 ， 会 触发 控件 之 上 的 onCheckedChanged 


事件 ， 然 后 mCheckBox 的 isChecked 方 法 来 判断 复 选 框 的 选中 和 未 选中 状态 ， 选 中 的 时 候 程序 会 从 mEditName 和 mEditPass 取 得 用 户 的 输入 字符 并 存储 到 应 用 配置 SharedPreference 中 去 ; 此外， 应 用 配 
置 的 有 关内 容 ， 我 们 将 紧 接 着 在 7.6.7 节 中 介绍 。 


dipl 


7.67 ”使 用 SharedPreference 


通过 第 2 章 中 对 Android 数 据 存储 相关 知识 的 学 习 (参考 2.6 节 ) ， 我 们 已 经 初步 了 解 应 用 配置 SshharedPreference 存 储 策略 的 用 法 。 作 为 一 种 轻 量 级 的 数据 存储 策略 ，SharedPreference 比 较 适 用 于 记 住 


密码 的 功能 ， 该 功能 的 逻辑 代码 请 参考 代码 清单 7-59。 


Bx, 


使 


另外 ， 


使 


辑 中 ,就 


getPreferences 对 象 获取 到 仅 供 应 用 内 部 访问 的 SharedPreference 对 象 ， 一 般 来 说 考虑 到 应 用 的 安全 性 ， 我 们 会 经 常 使 用 MODE_PRIVATE 模 式 。 然 后 ， 使 用 getBoolean 获 取 名 为 
remember 的 记 住 密码 状态 值 ， 该 数值 是 布尔 型 数据 ， 当 值 为 true 时 则 表示 目前 记 住 密码 复 选 框 正 处 于 选中 的 状态 ， 此 时 使 用 getString 方 法 取出 记录 好 的 账号 和 密码 信息 使 用 即 可 ;当然 ，remember 的 默 
认 值 是 false。 


SharedPreference 的 时 候 还 需要 注意 ， 如 果 需 要 往 应 用 配置 写 入 数值 的 时 候 ， 则 需要 使 用 edit 方 法 获取 SharedPreferences.Editor 类 的 editor 对 象 来 进行 操作 。 在 记 住 密码 复 选 框 的 选中 逻 


到 editor 对 象 的 putBoolean 和 putstring 方 法 来 修改 remember 状 态 值 和 账号 密码 的 数据 。 当 然 ， 最 后 还 必须 调 


通过 对 应 


中 。 


配置 存储 方案 的 实际 运 


表 7-4 SharedPreferences 类 常用 方法 


commit 方 法 来 提交 最 终 的 修改 。 


， 我 们 会 发 现 SharedPreferences 对 象 中 的 获取 方法 与 SharedPreferences.Editor 对 象 中 的 设置 方法 有 一 一 对 应 的 关系 ,我 们 把 这 些 方 法 的 对 应 关系 总 结 在 表 7-4 


SharedPreferences 获取 方法 


getBoolean(String key. boolean defValue) 
getFloat(String key. float defValue) 
getInt(String key. int defValue) 

getLong(String key. long defValue) 
getString(String key. String defValue) 
getStringSet(String key. Set<String> defValues) 


SharedPreferences.Editor 设置 方法 


putBoolean(String key. boolean value) 
putFloat(String key. float value) 
putlnt(String key. int value) 
putLong(String key. long value) 
putString(String key. String value) 


putStringSet(String key. Set<String> values) 


7.7” 微 博 列表 界面 


微 博 列表 界面 是 
学 习 Android 列 表 控 件 ListView 的 


片 的 用 法 ， 以 及 使 


7.7.1 ”界面 程序 逻辑 


微 博 列表 界面 的 最 主要 逻辑 就 是 从 服务 端的 微 博 列表 接口 〈 详 见 6.4.3 节 ) 中 获取 最 新 的 微 博 列表 并 展示 ， 微 博 列表 界 盏 


代码 清单 7-60 


户 登 录 成 功 之 后 看 到 的 第 一 个 界面 ， 也 是 用 户 浏览 微 博信 息 的 主要 界面 ， 也 被 称 作 微 博 主 界面 ， 该 界面 的 入 口 是 底 部 的 功能 选项 栏 最 左边 选项 按钮 。 在 微 博 列表 界面 中 ， 我 们 将 主要 
法 ; 此 外 ， 还 会 给 大 家 介绍 图 像 控件 的 使 用 ， 以 及 自 适 应 背景 的 制作 方法 ， 包 括 draw9patch 工 具 的 使 用 ;最 后 ， 还 会 有 异步 获取 远程 
SQLite 数 据 库 来 存 取 离 线 数据 的 技巧 。 


片 的 方法 和 使 用 SdCard 存 储 


D 
D 


对 应 的 界面 控制 器 类 是 Uilndex， 该 类 的 逻辑 实现 如 代码 清单 7-60 所 示 。 


package com.app.demos.ui; 
java.util.ArrayList; 
java.util.HashMap; 
.app.demos.R; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


com 


com. 
com. 
com. 
com. 
com. 


com 


com. 
com. 
com. 


.app.demos.base.C; 


app.demos. 
app.demos. 


android.os.Bundle; 
android.os.Message; 
android.view.View; 
android.view.KeyEvent; 
android.widget.AdapterView; 
android.widget.AdapterView.OnItemClickListener; 
android.widget.ImageButton; 
android.widget.ListView; 

class Uilndex extends BaseUiAuth ( 

private ListView blogListView; 

private BlogList blogListAdapter; 

private BlogSqlite blogSqlite; 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.ui index); 

// 设置 界面 消息 处 理 器 

this.setHandler (new IndexHandler (this) ); 


} 


// 设置 底部 选项 效果 


app.demos .base.BaseHandler; 
app.demos .base.BaseMessage; 
app.demos.base.BaseTask; 
app.demos .base.BaseUi; 
app.demos .base.BaseUiAuth; 


app.demos.list.BlogList; 
model.Blog; 
sqlite.BlogSqlite; 


ImageButton ib = (ImageButton) this.findViewById(R.id.main tab 1); 
ib.setImageResource (R.drawable.tab blog 2); 


// 初始 化 SQLite 对 象 


blogSqlite = new BlogSqlite (this); 


GOverride 
public void onStart () { 
super.onStart (); 


// 获取 微 博 列表 数据 


HashMap<String, String> blogParams = new HashMap<String, String>(); 
blogParams.put ("typeId", "0"); 

blogParams.put ("pageId", "0"); 

this.doTaskAsync(C.task.blogList, C.api.blogList, blogParams); 


$ 
//////////////////////////////////////////////////////////////////////////// 
// 异步 回调 方法 (ik ak 2k 3RR 3] 638 K 2 6 A SIAM) 

GOverride 
public void onTaskComplete(int taskId, BaseMessage message) { 
super.onTaskComplete (taskId, message); 


switch 


(taskId) ( 


case C.task.blogList: 


try { 


GSuppressWarnings ("unchecked") 
final ArrayList«Blog» blogList = (ArrayList«Blog») message. 
getResultList ("Blog"); 
// 获取 头像 图 片 
for (Blog blog : blogList) { 
loadImage (blog.getFace () ) ; 
blogSqlite.updateBlog (blog) ; 


l 

// 展示 微 博 列表 

blogListView = (ListView) this.findViewById(R.id.app index 
list view); n ui 
blogListAdapter = new BlogList(this, blogList); 


blogListView.setAdapter (blogListAdapter) ; 
blogListView.setOnItemClickListener (new OnItemClickListener () { 
GOverride 
public void onItemClick (AdapterView<?> parent, View view, int 
pos, long id) ( 
Bundle params - new Bundle(); 
params.putString("blogId", blogList.get (pos) .getId()); 
overlay (UiBlog.class, params); 
} 
n; 
} catch (Exception e) { 
e.printStackTrace (); 
toast (e.getMessage () ) ; 
] 
break; 
} 
š 
GOverride 
public void onNetworkError (int taskId) ( 
super.onNetworkError (taskId); 
toast (C.err.network) ; 
switch (taskId) { 
case C.task.blogList: 
try { 
final ArrayList«Blog» blogList = blogSqlite.getAl1Blogs (); 
// 获取 头像 图 片 
for (Blog blog : blogList) { 
loadImage (blog.getFace()); 
blogSqlite.updateBlog (blog) ; 


l 
// 展示 徽 博 列表 
blogListView = (ListView) this.findViewById(R.id.app index list view); 
blogListAdapter - new BlogList(this, blogList); 
blogListView.setAdapter (blogListAdapter); 
blogListView.setOnItemClickListener (new OnItemClickListener () { 
@Override 
public void onItemClick (AdapterView<?> parent, View 
view, int pos, long id) { 
Bundle params = new Bundle(); 
params.putString("blogId", blogList.get (pos) .getId()); 
overlay (UiBlog.class, params); 
l 
n; 
} catch (Exception e) { 
e.printStackTrace (); 
toast (e.getMessage () ) ; 
break; 


) 


} 
//////////////////////////////////////////////////////////////////////////// 
// 界面 按键 控制 


GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode 一 KeyEvent.KEYCODE BACK && event.getRepeatCount() = 0) { 


doFinish(); 
f 


return super.onKeyDown (keyCode, event); 


l 
//////////////////////////////////////////////////////////////////////////7/7 
// 自 定义 消息 处 理 类 
Private class IndexHandler extends BaseHandler { 
public IndexHandler (BaseUi ui) { 
super (ui); 
} 
GOverride 
public void handleMessage (Message msg) ( 
super.handleMessage (msg) ; 
try ( 
switch (msg.what) ( 
case BaseTask.LOAD IMAGE: 
blogListAdapter.notifyDataSetChanged () ; 
break; 
} 
} catch (Exception e) { 
e.printStackTrace () ; 
ui.toast (e.getMessage () ) ; 


中 比较 重要 的 方法 逻辑 进行 剖析 和 归纳 。 


Uilndex 类 继承 自 登录 界面 控制 类 BaseUiAuth (参考 7.5.1 节 ) ， 该 类 的 代码 比较 长 、 涉 及 的 知识 点 也 比较 多 ， 下 面 我 们 仅 对 : 


m 


1.onCreate 方 法 


IR] 


片 成 功 加 载 的 消息 ， 作 用 和 用 法 将 在 7.7.5 节 中 介绍 。 然 后 ， 程 序 还 设置 了 底部 选项 按钮 的 样式 ， 也 就 是 把 首 个 


界面 初始 化 逻辑 。 首 先 ， 设 置 了 自 定义 的 消息 处 理 器 ， 即 IndexHandler， 该 类 用 于 接收 
按钮 设置 成 选中 状态 。 最 后 ， 初 始 化 BlogSqlite 对 象 ， 详 情 见 7.7.7 节 。 


2.0nStart 方 法 


为 了 每 次 刷新 界面 的 时 候 都 能 从 服务 端 获取 最 新 的 微 博 列表 数据 ， 我 们 把 相关 的 doTaskAsyn<c 方 法 放 到 了 onstart 方 法 中 ;异步 任务 的 ID 是 C.task.blogList， 请 求 的 服务 端 API 地 址 即 C.api.blogList 常 量 
的 值 。 


3.onTaskComplete 方 法 


成 功 获取 服务 端 返回 时 的 逻辑 ， 用 于 处 理 微 博 列表 信息 的 展示 。 由 于 是 列表 型 数据 ， 所 以 程序 使 用 BaseMessage 的 getResultList 方 法 来 获取 Blog 模 型 列表 数据 ， 此 方法 的 使 用 可 参考 前 面 7.3.3 节 的 内 
容 。 微 博 列表 的 展示 还 涉及 列表 控件 ListView 的 使 用 、 图 像 控件 ImageView 的 使 用 、 异 步 获 取 远 程 图 片 以 及 图 片 缓存 与 数据 缓存 的 知识 ， 我 们 将 在 后 面 的 小 节 中 详细 介绍 。 


中 | 


4.onNetworkError 方 法 


步 任务 的 网 络 请 求 失败 时 的 逻辑 ， 即 在 获取 最 新 微 博 信息 失败 时 ， 也 要 显示 出 历史 微 博 列表 的 信息 。 在 实际 应 用 中 常会 有 类 似 的 逻辑 ， 这 主要 是 考虑 到 用 户 的 体验 问题 ， 如 果 网 络 失败 就 显示 不 了 微 
博 列 表 ， 那 么 用 户 体验 就 会 变 得 很 差 。 另 外 ， 移 动 网 络 本 身 就 不 是 非常 稳定 ， 所 以 在 移动 互联 网 应 用 中 我 们 必须 要 考虑 到 断 网 情况 的 处 理 。 实 际 上 ， 这 里 我 们 就 采用 了 SQLite 数 据 库 来 缓存 微 博 数据 ， 以 备 
在 网 络 请 求 失败 的 情况 下 使 用 ， 这 部 分 内 容 我 们 将 在 7.7.7 节 中 做 详细 介绍 。 


至 此 ， 微 博 列表 界面 的 程序 逻辑 已 经 介绍 完毕 。 下 面 是 微 博 列表 界面 的 模板 文件 ui_index.xml， 如 代码 清单 7-61 所 示 。 


代码 清单 7-61 


<?xml version-"1.0" encoding-"utf-8"?» 
«merge xmlns:androide"http://schemas.android.com/apk/res/android"» 
«include layout-"8layout/main layout" /> 
<LinearLayout 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
<include layout="@layout/main_top" /> 
<LinearLayout T 


android:orientation="vertical" 


android: layout_widt! 


fill parent" 


android:layout height-"wrap content" 
android:layout weight-"1"» 


<ListView 


android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


</LinearLayout> 


id="@+id/app index list view" 

layout width-"fill parent" 

layout height-"wrap content" 
descendantFocusability-"blocksDescendants" 
fadingEdge-"vertical" 
fadingEdgeLength="5dip" 

divider="@null" 
listSelector="@drawable/xml_list_bg" 
cacheColorHint="#00000000" 7» ~ 


«include layout-"8layout/main tab" /> 


</LinearLayout> 
</merge> 


微 博 列表 界面 的 显示 效果 如 区 


7-16 所 示 。 


-— 


a ++ 10:01 


demas ü 


lames | rer blog š 
panes Cer blog : 


pases ;cesr blog! 


7-16 微 博 列表 界面 运行 效果 


7.7.2 ”使 用 ListView 


ListView 即 列表 控件 ， 用 于 展示 列表 型 数据 。ListView 是 Android 应 用 开发 中 最 重要 的 UI 控 件 之 一 ， 是 我 们 需要 重点 掌握 的 知识 。ListView 类 位 于 android.widget 包 下 ， 继 承 自 ViewGroup， 下 面 是 
ListView 类 的 继承 关系 。 


java.lang.Object 
|- android.view.View 
|- android.view.ViewGroup 
|- android.widget .AdapterView 
|- android.widget.AbsListView 
|- android.widget.ListView 


ListView 继 承 了 View 和 ViewGroup 的 所 有 属性 ， 我 们 把 ListView 控 件 特有 属性 的 使 用 方法 以 及 属性 对 应 的 操作 方法 总 结 在 表 7-5 中 。 


表 7-5 ListView 控 件 常 用 属性 


属性 名 操作 方法 使 用 说 明 


android:cacheColorHint setCacheColorHint(int color) 列表 项 背景 颜色 ， 如 果 是 用 图 片 做 背景 则 需要 指定 
为 透明 ， 即 #00000000 

android:divider setDivider(Drawable divider) 列表 项 之 间 的 分 阳线 ， 如 果 不 显 示 分 阳线 则 设置 为 
无 分 阳线 ， 即 @null 

android:dividerHeight setDividerHeight(int height) 分 隔 线 高 度 

android:fadingEdge 列表 上 下 边缘 是 否 有 阴影 

android:listSelector setSelector(int) 当前 选中 列表 项 的 样式 

android:stackFromBottom 列表 项 按照 从 上 到 下 顺序 填充 


ui_index.xml 模 板 文件 中 可 以 看 到 微 博 列 表 的 标签 声明 ， 见 代码 清单 7-61 中 ListView 的 相关 代码 。 我 们 可 以 看 出 微 博 列 表 使 用 的 是 透明 背景 ， 没 有 分 隔 线 ， 设 置 了 垂直 方向 的 阴影 ， 且 当前 选中 列表 项 
的 样式 为 @drawable/xml_list_bg。 


准备 好 ListView 控 件 的 模板 声明 之 后 ， 接 下 来 需要 考虑 如 何 把 数据 展示 到 ListView 的 列表 项 中 去 。 为 了 达到 这 个 目的 ， 我 们 需要 借助 适配器 类 (Adapter) 来 完成 。 Android 应 用 框架 给 我 们 提供 了 丰富 
的 Adapter 适 配器 ， 常 见 的 有 BaseAdapter、ArrayAdapter、CursorAdapter 以 及 SimpleAdapter 等 ， 其 中 BaseAdapter 是 所 有 Adapter 类 的 基 类 ， 这 几 个 类 之 间 的 关系 如 图 7-17 所 示 。 


D 


BaseAdapter 


ArrayAdapter CursorAdapter SimpleAdapter 


7-17 Adapter 适 配器 类 图 


在 这 些 Android 系 统 提供 的 适配器 之 中 ， 我 们 通常 会 使 用 SimpleAdapter 来 作为 ListView 的 适配器 ， 因 为 SimpleAdapter 的 扩展 性 比较 好 ， 使 用 起 来 也 相对 比较 简单 ， 只 需要 传 入 指定 的 参数 创建 出 符 
合 要 求 的 适配器 对 象 即 可 。 我 们 关注 一 下 SimpleAdapter 类 构造 方法 的 5 个 参数 ， 使 用 范例 如 代码 清单 7-62 所 示 。 


代码 清单 7-62 


// 根据 资源 ID 获取 ListView 对 象 
ListView listView = (ListView) findViewById(R.id.listitem); 
// 构建 Adapter 数 据 项 集合 
ArrayList<Map<String, Object>> data = new ArrayList<Map<String, Object>>(); 
for (int i = 0; i < 10; i++) { 
Map<String, Object> map = new HashMap<String, Object>(); 
map.put("TITLE", "Test title " + i); 
map.put("CONTENT", "Test content " + i); 
data.add (map) ; 


l 
// 数据 项 字段 名 
String[] from = new String[] { "TITLE", "CONTENT" }; 
// 数据 项 字段 对 应 的 控件 资源 ID 
int[] to = new int[] ( R.id.listitem title, R.id.listitem content ); 
// 创建 SimpleAdapter 对 象 = T 
SimpleAdapter adapter = SimpleAdapter ( 
this, // 界面 上 下 文 
data, 
R.layout.listitem, // 数据 项 模板 资源 ID 
from, 


to 


); 
// 设置 Adapter 对 象 
listView.setAdapter (adapter); 


然而 ， 在 实际 项 目 中 我 们 往往 还 需要 获得 更 大 的 扩展 自由 度 ， 这 时 我 们 就 需要 考虑 使 
位 于 com.app.demos.list 包 下 ， 其 中 也 包括 微 博 列表 的 适配器 类 BlogList。 而 BlogList 类 继承 


自 定义 的 适配器 类 了 。 实 际 上 ， 微 博 应 


中 的 大 部 分 ListView 都 使 用 程序 框架 自 定义 的 适配器 类 ， 这 些 适 配器 类 


框架 适配器 基 类 BaseList， 完 整 的 类 继承 关系 如 下 。 


java.lang.Object 
|- android.widget.BaseAdapter 
|- com.app.demos.base.BaseList 
|- com.app.demos.list.BlogList 


Android 里 的 所 有 适配器 都 需要 实现 Adapter 接 


代码 清单 7-63 


package com.app.demos.list; 
import java.util.Arraylist; 
import com.app.demos.R; 
import com.app.demos.base.BaseUi; 
import com.app.demos.base.BaseList; 
import com.app.demos.model.Blog; 
import com.app.demos.util.AppCache; 
import com.app.demos.util.AppFilter; 
import android.graphics.Bitmap; 
import android.view.LayoutInflater; 
import android.view.View; 
import android.view.ViewGroup; 
import android.widget.ImageView; 
import android.widget.TextView; 
public class BlogList extends BaseList ( 
private BaseUi ui; 
private LayoutInflater inflater; 
private ArrayList<Blog> blogList; 
public final class BlogListItem { 
public ImageView face; 
public TextView content; 
public TextView uptime; 
public TextView comment; 
} 
public BlogList (BaseUi ui, ArrayList<Blog> blogList) 
this.ui = ui; 
this.inflater 


{ 


LayoutInflater.from(this.ui); 


this.blogList = blogList; 
} 
GOverride 
public int getCount() { 

return blogList.size(); 


} 

GOverride 

public Object getItem(int position) 
return position; 


{ 


} 

GOverride 

public long getItemId(int position) 
return position; 


{ 


} 
GOverride 
public View getView(int p, View v, ViewGroup parent) ( 
// 初始 化 列表 项 数据 对 象 
BlogListItem blogItem = null; 
// 列表 缓存 实效 时 填充 数据 
if (v == null) ( 
v = inflater.inflate(R.layout.tpl list blog, null); 


， 当 然 也 包括 BaseList 类 以 及 其 子 类 ， 必 须 实 现 的 方法 包括 getCount、getltem、getltemld 和 getView 等 ; 
于 获取 列表 项 的 View 对 象 ， 然 后 进行 填充 和 演 染 。 微 博 列表 使 用 的 就 是 自 定义 适配器 类 BlogList， 实 现 逻 辑 参考 代码 清单 7-63。 


个 接 


" 


其 中 最 重 


的 就 是 getView 接 口 ， 


blogItem = new BlogListItem(); 

blogItem.face = (ImageView) v.findViewById(R.id.tpl list blog image face); 
blogItem.content - (TextView) v.findViewById(R.id.tpl list blog text content); 
blogItem.uptime = (TextView) v.findViewById(R.id.tpl list blog text uptime); 
blogItem.comment = (TextView) v.findViewById(R.id.tpl list blog text comment); 
v.setTag (blogItem); 


) eise ( 
blogItem = (BlogListItem) v.getTag(); 


i 
// 填充 数据 
blogItem.uptime.setText (blogList.get (p) .getUptime ()); 


blogItem.content.setText (AppFilter.getHtml (blogList.get (p) .getContent () 
blogItem.comment.setText (AppFilter.getHtml (blogList.get (p) .getComment () 


// 加 载 图 片 

String faceUrl = blogList.get (p) .getFace () ; 

Bitmap faceImage = AppCache.getImage (faceUrl) 7 

if (faceImage != null) { 
blogItem.face.setImageBitmap (faceImage) ; 

l 


return v; 


BlogList 类 主要 包含 两 方面 的 内 容 ， 首 先是 类 
BlogListltem， 该 类 的 
项 的 模板 对 象 ， 即 tpl | 


属性 定义 ，BlogList 类 中 比较 重要 的 属性 有 界 


BlogList 适 配器 的 


法 很 简单 ， 使 


setOnltemClickListener 来 设置 每 个 微 博 列表 项 的 点 击 事件 监听 器 ; 按照 逻辑 ， 点 击 之 后 需要 显示 对 应 微 博 的 详情 界 


代码 清单 7-64 


)); 
)); 


属性 都 是 列表 项 所 包含 的 控件 元 素 的 对 象 。 然 后 就 是 getView 方 法 的 实现 逻辑 : 先 从 方法 传递 的 参数 中 获取 到 与 列表 项 对 应 的 View 对 象 ; 然后 使 
ist_blog.xml， 再 从 模板 对 象 中 获取 控件 对 象 并 保存 到 BlogListltem 中 去 ; 接着 给 BlogListltem 中 的 控件 对 象 填充 数据 并 加 载 | 


ListView 对 象 的 setAdapter 方 法 设置 即 可 ， 而 后 UI 线程 就 将 根据 BlogList 适 配器 的 逻辑 来 泻 染 微 博 列 表 并 


面 对 象 ui， 布 局 对 象 inflater 以 及 微 博 数 据 列表 blogList。 此 外 ， 该 类 中 还 定义 了 与 列表 项 对 应 的 内 部 类 
布局 对 象 的 inflate 方 法 来 获取 列表 
图 片 ; 最 后 返回 处 理 完毕 的 View 对 象 。 


展示 到 设备 屏幕 上 。 此 外 ， 我 们 还 需要 通过 ListView 对 象 的 
( 见 本 章 7.9 节 ) 。 以 上 催 辑 实现 可 参考 代码 清单 7-64。 


， 即 微 博文 章 界 


Ë 


A 


blogListAdapter = new BlogList (this, blogList); 

blogListView.setAdapter (blogListAdapter) ; 

blogListView.setOnItemClickListener (new OnItemClickListener () { 
GOverride 


public void onItemClick(AdapterView«?» parent, View view, int pos, long id) 


Bundle params = new Bundle(); 
params.putString("blogId", blogList.get (pos) .getId()); 
overlay (UiBlog.class, params); 


n; 


当然 ， 微 博 列表 的 数据 是 对 象 数组 ， 


终 展示 效果 如 图 7-16 所 示 。 
至 于 微 博 列表 项 对 应 的 模板 文件 tpl_list_blog.xm| 我 们 暂 不 在 这 里 讨论 ， 因 


7-18 所 示 。 


{ 


为 该 模板 的 内 容 并 不 复杂 ， 而 | 


因此 需要 通过 BaseMessage 的 getResultList 方 法 来 获取 ， 逻 辑 可 请 参考 Uilndex 类 中 onTaskComplete 方 法 前 面部 分 的 代码 ， 详 见 代码 清单 7-60。 而 微 博 列表 的 最 


目 在 本 章 之 后 的 内 容 中 也 将 对 其 中 的 重点 做 详细 介绍 。 不 过 我 们 可 以 先 看 看 该 模板 的 预览 


， 如 


[ 


#£7-18 ” 微 博 列表 项 模板 预览 界面 


7.4.3 ”使 用 mageView 


L3 


像 控件 ， 常 用 于 | 


展示 ， 可 加 载 多 种 来 源 的 


像 ， 并 且 很 方便 地 调整 


ImageView 即 
系 。 


像 的 大 小 、 颜 色 等 。ImageView 类 位 于 android.widget 包 下 ， 继 承 自 View， 下 面 是 ImageView 类 的 继承 关 


区 
D 
I) 


java.lang.Object 
|- android.view.View 
|- android.widget.ImageView 


ImageView 继 承 了 View 的 所 有 属性 ， 我 们 把 ImageView 控 件 属性 的 使 用 方法 以 及 属性 对 应 的 操作 方法 总 结 在 表 7-6 中 。 


表 7-6 ”ImageView 控 件 常用 属性 


属性 名 操作 方法 使 用 说 明 

android:adjustViewBounds setAdjustViewBounds(boolean) 是 否 要 保持 宽 高 比 ， 需 要 与 android: 
maxHeight 以 及 android:maxWidth 一 起 使 用 

android:cropToPadding setDivider(Drawable divider) 是 否 按 照 Padding 来 截取 图 片 

android:maxHeight setMaxHeight(int) 设置 View 的 最 大 高 度 ， 单 独 使 用 无 效 ， 需 要 
与 setAdjustViewBounds 一 起 使 用 

android:max Width setMax Width(int) 设置 View 的 最 大 宽度 ， 同 上 

android:scaleType setScaleType(ImageView.ScaleType) ”设置 图 片 的 填充 方式 : 


center 居中 显示 ， 不 缩放 

centerCrop 居中 显示 ， 超 出 部 分 被 截 去 
centerInside 居中 显示 ， 缩 放 图 片 不 超出 控件 
fitCenter 按 比 例 拉 伸 并 居中 

fitEnd 按 比 例 拉 伸 并 居 右 

fitStart 按 比 例 拉 伸 并 居 左 

fitXY 水 平 拉 伸 ， 填 满 整 个 控件 


android:src setlmageResource(int) 图 片 资 源 ， 一 般 是 Drawable 资源 对 象 
android:tint setColorFilter(int.PorterDuff.Mode) 设置 图 片 颜色 


在 微 博 列表 界面 中 ， 用 户头 像 就 是 使 用 mageView 来 实现 的 ， 在 微 博 列表 项 对 应 的 模板 文件 tpl_list_blog.xml 中 就 可 以 看 到 与 ImageView 的 相关 的 模板 声明 ， 如 代码 清单 7-65 所 示 。 


代码 清单 7-65 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
«ImageView u 
android:id-"Q(*id/tpl list blog image face" 
android:layout width-"50dip" 
android:layout height-"50dip" 
android:layout margin-"5dip" 
android: src="@drawable/face" 
android: scaleType="fitXY" 
android: focusable="false"/> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</LinearLayout> 


以 上 的 ImageView 控 件 大 小 是 固定 的 ， 


像 就 是 


片 使 用 水 平 拉 伸 的 填充 方式 ， 这 主要 是 考虑 到 


片 的 自 适 应 性 ， 默 认 头像 资源 是 @drawable/face， 模 板 预 览 效果 如 图 7-18 所 示 ， 左 边 的 框 内 圆 形 的 


I) 
D 
D 


该 ImageView 控 件 。 


从 微 博 列表 适配器 BlogList 类 ( 见 代码 清单 7-63) 的 代码 中 ， 我 们 可 以 看 到 lImageView 控 件 的 使 用 。 在 getView 方 法 中 ， 我 们 把 该 控件 对 象 存放 于 blogltem.face 中 ， 并 使 用 setlmageBitmap 来 设置 从 
缓存 中 获取 到 的 图 像 。 这 里 需要 注意 的 是 ，ImageView 类 提供 了 多 种 设置 图 像 资源 的 方法 ， 现 在 我 们 将 这 些 方法 归纳 于 表 7-7 中 。 


D 


表 7-7 ”ImageView 类 设置 图 像 资源 的 方法 


方法 名 使 用 说 明 


setImageBitmap(Bitmap bm) 设置 Bitmap 对 象 作为 图 像 内 容 
setlmageDrawable(Drawable drawable) 设置 Drawable 对 象 作为 图 像 内 容 
setlmageResource(int resId) 设置 资源 ID 所 对 应 Drawable 对 象 作 为 图 像 内 容 
setImageURI(Uri uri) 设置 URI 引 用 的 资源 作为 图 像 内 容 


学 会 使 用 以 上 这 些 方法 ， 我 们 可 以 很 方便 地 加 载 所 需 的 图 像 资源 。 当 然 ， 从 这 里 我 们 还 可 以 看 到 Android 系 统 中 几 种 图 像 资 源 类 ， 即 Bitmap 位 图 类 与 Drawable 图 像 资 源 类 ， 这 两 者 之 间 的 区 别 
是 ，Bitmap 相 对 比较 具体 ， 常 用 于 操控 实际 图 片 的 属性 和 效果 ; 而 Drawable 则 比较 抽象 ， 其 概念 更 像 是 所 有 图 形 的 集合 ， 既 包括 图 像 (Image) 也 包括 图 形 (Shape) ， 常 用 于 图 像 资源 的 引用 和 转化 。 
当然 ，Bitmap 与 Drawable 之 间 也 是 可 以 相互 转化 的 ， 不 过 这 个 过 程 需要 用 到 画布 类 Canvas 等 ， 这 些 内 容 已 经 超出 了 本 书 的 知识 范围 ， 这 里 不 再 介绍 ， 有 兴趣 的 话 可 以 参考 SDK 文 档 中 的 相关 内 容 。 


7.14 使 用 draw9patch 


为 了 让 微 博 列表 的 界面 效果 更 棒 ， 我 们 采用 了 一 个 比较 炫 的 效果 ， 那 就 是 采用 了 “对 话 框 ”样式 的 图 形 来 作为 每 条 微 博 信息 的 背景 。 由 于 “对 话 框 ”图 形 是 带 圆 角 的 ， 而 微 博 的 内 容 又 是 可 长 可 短 的 ， 
所 以 这 种 背景 要 做 到 长 宽 自 适应 是 很 困难 的 。 不 过 ， 好 在 Android 系 统 为 我 们 提供 了 draw9patch 工 具 来 帮助 我 们 解决 这 个 问题 。 下 面 我 们 就 以 微 博 列表 界面 为 例 来 学 习 一 下 如 何 使 用 draw9patch 工 具 来 制 
作 自 适应 的 背景 图 片 。 


首先 ， 我 们 需要 把 带 圆 角 的 “对 话 框 ”图 片 准备 好 ; 然后 ， 打 开 Android SDK 目 录 下 的 tools 目 录 ， 找 到 draw9patch.bat 文 件 ， 双 击 打开 该 工具 然后 载 入 “对 话 框 ”背景 图 片 ， 打 开 项 部 的 “Show bad 
patches” 选 项， 效果 如 图 7-19 所 示 。 


通过 描画 图 像 的 边缘 ， 可 以 调整 各 条 边 可 自 适应 拉 伸 的 区 域 ， 我 们 还 可 以 通过 调整 底部 的 “Patch scale” 选 项 来 观察 右边 预览 框 中 的 放大 和 缩小 效果 。 最 后 ， 将 图 片 保存 为 以 “9.png” 为 后 缀 名 的 
片 文件 并 保存 到 项 目的 资源 目录 res/drawable/ 下 ， 在 微 博 应 用 中 blog_1.9.png 和 blog_2.9.png 两 张 图 片 就 是 我 们 准备 好 的 微 博 列表 项 的 自 适应 背景 。 我 们 可 以 在 微 博 列表 项 模板 tpl_list_log.xml 中 找到 相关 
的 声明 代码 ， 如 代码 清单 7-66 所 示 。 
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代码 清单 7-66 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...» 
http: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
<LinearLayout 
android: orientation="vertical" 
android: layout_width="fi1l parent" 
android:layout height-"wrap content" 
android:paddingLeft-"5dip" 
android:paddingRight="5dip" 
android: focusable="false" 
android:background="@drawable/xml_list_blog_bg"> 
http://www. hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
</LinearLayout> 
</LinearLayout> 


Em nrar U-patrh 
File 


Press Shift ta arase pixels | Hide bad patches 


图 7-19 ”9patch 图 片 制作 


以 上 代码 中 垂直 方向 (vertical) 的 LinearLayout 线 性 布局 控件 就 是 微 博 内 容 的 容器 ， 其 背景 是 @drawable/xml list blog bg， 对 应 res/drawable/ 目 录 下 的 xml_list_blog_ bg.xm| 资 源 文件 ， 如 代码 清 
单 7-67 所 示 。 这 里 还 使 用 了 Selector 组 件 来 切换 正常 和 按 下 状态 的 效果 ， 该 组 件 的 相关 知识 请 参考 7.6.5 节 中 内 容 。 


代码 清单 7-67 


<?xml version-"1.0" encoding-"utf-8"?» 

<selector xmlns:android-"http://schemas.android.com/apk/res/android"» 
<item android:state pressed-"true" android:drawable-"G(drawable/blog 2" /> 
<item android:state focused-"true" android:drawable="@drawable/blog_2" /> 
<item android:drawable-"Q(drawable/blog 1" /> 

«/selector» E 


如 


的 拉 伸 效果 。 最 终 的 效果 还 是 很 不 错 的， 界面 截 7-20 所 示 。 
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最 后 ， 我 们 可 以 尝试 输入 不 同 长 度 的 微 博 内 容 来 测试 自 适应 背景 


D 
D 


demas 
pol ian iag 


Moor 2 DIE DELL sosta renean 


2012-05-45 1427:35 FE) j 


q 0. S 


james : short blog 


2012-05-24 14:30:10 Fen | 


sas 


图 7-20 ”9patch 图 像 应 用 


775 “异步 获取 远程 图 片 


我 们 都 知道 ， 微 博 的 内 容 是 从 服务 端 获取 的 ， 当 然 也 包括 用 户 的 头像 ， 但 是 图 片 资源 往往 比较 大 ， 如 果 每 次 加 载 列表 的 时 候 都 去 服务 端 获取 的 话 ， 一 方面 会 极 大 地 增加 网 络 资源 的 消耗 ， 另 一 方面 也 会 
大 大 降低 列表 展示 的 效率 ， 给 用 户 体验 带 来 不 良 的 影响 。 所 以 ， 我 们 使 用 了 异步 加 缓存 的 方式 来 解决 这 个 问题 。 


前 面 在 介绍 BlogList 代 码 的 时 候 〈( 见 代码 清单 7-63) ， 我 们 了 解 到 在 获取 微 博 对 应 的 用 户头 像 时 ， 会 使 用 AppCache 类 的 getCachedlmage 方 法 来 获取 缓存 中 的 图 像 ， 此 方法 的 实现 逻辑 见 代码 清单 7- 
68。 


代码 清单 7-68 


package com.app.demos.util; 
import android.content.Context; 
import android.graphics.Bitmap; 
import android.util.Log; 
public class AppCache ( 
private static String TAG = AppCache.class.getSimpleName () ; 
public static Bitmap getCachedImage (Context ctx, String url) { 
String cacheKey = AppUtil.md5 (url); 
Bitmap cachedImage = SDUtil.getImage (cacheKey) ; 
if (cachedImage != null) { 
Log.w(TAG, "get cached image"); 
return cachedImage; 
) else ( 
Bitmap newImage = IOUtil.getBitmapRemote (ctx, url); 
SDUtil.savelmage (newImage, cacheKey) ; 
return newImage; 
} 
} 
public static Bitmap getImage (String url) { 
String cacheKey = AppUtil.md5 (url); 
return SDUtil.getImage (cacheKey) ; 
} 


首先 ， 我 们 通过 M D5 算法 获取 url 地 址 的 唯一 值 ， 然 后 尝试 使 用 SdCard 工 具 类 SDUtil 中 的 getlImage 方 法 从 SdCard 中 获取 被 缓存 的 图 片 ， 此 方法 我 们 会 在 7.7.6 节 中 介绍 ， 本 节 暂 不 讨论 。 若 获取 失败 ， 
则 使 用 输入 输出 工具 类 1OUtil 类 中 的 getBitmapRemote 方 法 来 获取 远程 图 片 ， 然 后 再 使 用 SDUtil 类 的 savelmage 方 法 把 获取 到 的 保存 到 SdCard 的 缓存 中 去 。 


小 贴 士 : MD5 是 一 种 常用 的 信息 摘要 算法 (Message Digest Algorithm) ， 具 有 唯一 性 的 特点 。 其 作用 是 把 大 容量 的 信息 转化 和 压缩 成 密 钥 的 格式 (经 常 是 32 位 的 字符 囊 ) ， 常 用 于 数字 签名 等 。 其 他 常用 
的 算法 还 有 shal、crc32 等 。 


接着 ， 我 们 来 介绍 IOUtil 类 中 获取 远程 图 片 的 相关 逻辑 ， 如 代码 清单 7-69 所 示 。 


代码 清单 7-69 


package com.app.demos.util; 
import java.io.FileInputStream; 


import java.io.FileNotFoundException; 
import java.io.IOException; 
import java.io.InputStream; 
import java.net.HttpURLConnection; 
import java.net.InetSocketAddress; 
import java.net.MalformedURLException; 
import java.net.Proxy; 
import java.net.URL; 
import android.content.Context; 
import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.util.Log; 
public class IOUtil ( 
private static String TAG = IOUtil.class.getSimpleName(); 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 获取 网 络 图 片 
public static Bitmap getBitmapRemote (Context ctx, String url) { 
URL myFileUrl = null; 
Bitmap bitmap = null; 
try { 
Log.w(TAG, url); 
myFileUrl = new URL(url); 
} catch (MalformedURLException e) { 
e.printStackTrace () ; 
l 
try ( 
HttpURLConnection conn - null; 
if (HttpUtil.WAP INT == HttpUtil.getNetType(ctx)) ( 
Proxy proxy = new Proxy (java.net.Proxy.Type.HTTP, new 
InetSocketAddress ("10.0.0.172", 80)); 
conn = (HttpURLConnection) myFileUrl.openConnection (proxy); 
) eise ( 
conn = (HttpURLConnection) myFileUrl.openConnection(); 
š 
conn.setConnectTimeout (10000) ; 
conn.setDoInput (true); 
conn.connect (); 
InputStream is = conn.getInputStream(); 
bitmap = BitmapFactory.decodeStream (is); 
is.close(); 
} catch (IOException e) { 
e.printStackTrace () ; 


return bitmap; 


在 getBitmapRemote 方 法 中 ， 我 们 使 有 


此 外 ， 我 们 还 需要 学 习 使 用 BitmapFactory 类 中 的 decodestream 方 法 从 读 取 数 据 流 对 象 中 读 取 
对 象 的 各 种 方法 ， 归 纳 于 表 7-8 中 。 


[D 


表 7-8 ”BitmapFactory 构 造 Bitmap 对 象 方 法 


了 HttpURLConnection 类 来 完成 HTTP 网 络 请 求 ， 与 HttpClient 不 同 的 是 ，HttpURLConnection 更 易于 进行 数据 流 的 操作 ， 


在 这 里 会 更 加 合适 。 


片 的 信息 。 这 里 我 们 需要 注意 BitmapFactory 类 的 用 法 ， 该 类 是 Bitmap 的 工厂 类 ， 提 供 了 构造 Bitmap 


方法 名 
decodeByteArray(byte[] data. int offset. int length) 
decodeFile(String pathName) 
decodeFileDescriptor(FileDescriptor fd) 


decodeResource(Resources res. int id) 


使 用 说 明 
从 指定 Byte 数组 创建 Bitmap 
从 指定 路 径 的 文件 创建 Bitmap 
通过 FileDescriptor 句柄 创建 Bitmap 
通过 资源 ID 创建 Bitmap 


decodeStream(InputStream 1s) 


通过 输入 流 创建 Bitmap 


当然 ， 如 果 仅 仅 使 
onTaskComplete 方 法 中 找到 循环 使 


AppCache 类 的 getCachedlmage 来 获取 图 片 ， 虽 然 实现 图 片 的 缓存 机 制 ， 但 是 却 没 能 做 到 异步 ， 因 此 我 们 还 需 
loadlmage 来 加 载 图 片 的 逻辑 ， 参 考 代 码 清单 7-60。 而 loadlmage 就 是 BaseUi 类 所 提供 的 异步 加 载 


[I 


[R] 


代码 清单 7-70 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void loadImage (final String url) { ul 
taskPool.addTask(0, new BaseTask() { 
GOverride 
public void onComplete () { 
AppCache.getCachedImage (getContext(), url); 
sendMessage (BaseTask.LOAD IMAGE); 
} 
i }, 0); 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
] 


在 微 博 列表 的 界面 控制 器 类 Uilndex 中 配合 地 做 一 些 工作 ， 可 以 在 
片 的 方法 ， 该 方法 的 实现 逻辑 如 代码 清单 7-70 所 示 。 


首先 ， 每 次 执行 loadlmage 的 时 候 ， 都 将 启动 一 个 新 的 异步 任务 ， 在 该 任务 中 ， 程 序 将 会 使 用 前 面 介绍 过 的 AppCache 类 中 的 getCachedlmage 来 缓存 图 片 ; 然后 ， 该 任务 完成 之 后 会 发 送 消息 给 


IndexHandler 处 理 器 ， 执 行 其 中 与 BaseTask.LOAD IMAGE 任务 相关 的 逻辑 ， 即 调用 BlogList 适 配器 类 的 notifyDataSetChanged 来 通知 刷新 列表 项 ; 最 后 ， 调 
的 显示 。 这 种 做 法 把 异步 任务 和 图 片 缓存 结合 在 一 起 ， 比 较 完 美 地 优化 了 微 博 列表 的 展示 。 


7.7.6 ”使 用 SdCard 缓 存 图 片 


通过 上 节 内 容 的 介绍 ， 我 们 了 解 到 可 以 利用 SdCard 作 为 微 博 图 片 的 缓存 。 其 实 很 多 Android 应 用 也 经 常会 把 一 些 常 


的 操作 都 归纳 到 工具 类 SDUtil 中 ， 下 面 我 们 便 来 分 析 其 中 与 存 取 图 片 功能 相关 的 方法 ， 如 代码 清单 7-71 所 示 。 


IR] 


的 文件 和 


代码 清单 7-71 


BlogList 类 中 的 getView 方 法 来 更 新 数据 项 


片 保存 在 sdCard 中 。 在 微 博客 户 端 程序 框架 中 ， 我 们 把 与 sdCard 有 关 


package com.app.demos.util; 

import java.io.File; 

import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io.IOException; 

import java.io.OutputStream; 

import java.util.Arrays; 

import java.util.Comparator; 

import com.app.demos.base.C; 

import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.os.Environment; 

import android.os.StatFs; 

import android.util.Log; 


public class SDUtil { 
private static String TAG = SDUtil.class.getSimpleName () 
private static double MB = 1024; 


private static double FREE SD SPACE NEEDED TO CACHE = 10; 


// 从 SdCard 中 获取 图 片 
public static Bitmap getImage (String fileName) { 
// 查看 文件 是 否 存在 


String realFileName = C.dir.faces + "/" + fileName; 


File file = new File(realFileName) ; 
if (!file.exists()) { 
return null; 


} 

// 获取 原 图 

BitmapFactory.Options options = new BitmapFactory. 
options.inJustDecodeBounds = false; 


Options (); 


return BitmapFactory.decodeFile (realFileName, options); 


l 
// 保存 图 片 到 SdCard 上 


public static void saveImage (Bitmap bitmap, String fileName) { 


if (bitmap == null) { 
Log.w(TAG, " trying to save null bitmap"); 
return; 


} 
// 判断 SdaCard 上 的 空间 
if (FREE SD SPACE NEEDED TO CACHE > getFreeSpace () 


)` 1 


Log.w (TAG, "Low free space onsd, do not cache"); 


return; 


l 

// 不 存在 则 创建 目录 

File dir = new File(C.dir.faces); 

if (!dir.exists()) { 
dir.mkdirs(); 


) 
// RAAR 
try { 


String realFileName = C.dir.faces + "/" + fileName; 


File file = new File(realFileName) ; 
file.createNewFile(); 


OutputStream outStream = new FileOutputStream(file); 


bitmap.compress (Bitmap.CompressFormat.PNG, 1 
outStream.flush(); 
outStream.close(); 
Log.i(TAG, "Image saved tosd"); 
} catch (FileNotFoundException e) { 
Log.w(TAG, "FileNotFoundException"); 
] catch (IOException e) ( 
Log.w(TAG, "IOException"); 
} 


$ 
// 计算 SdCard 上 的 剩余 空间 
public static int getFreeSpace() { 
StatFs stat = new StatFs (Environment.getExternalSt 


00, outStream) ; 


orageDirectory ().getPath()); 


double sdFreeMB = ((double) stat.getAvailableBlocks() * (double) stat. 


getBlockSize()) / MB; 
return (int) sdFreeMB; 
} 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


SDUtil 类 中 与 存 取 


IR] 


1.getlmage 方 法 


[I 


获取 


2.savelmage 方 法 


片 相关 的 方法 有 两 个 ， 即 getlmage 和 savelmage。 以 上 两 个 方法 分 别 用 于 从 SdCard 中 获取 图 片 和 将 


片 逻 辑 比较 简单 ， 直 接 使 用 BitmapFactory 类 中 的 decodeFile 方 法 来 获取 对 应 位 置 的 图 片 文件 ， 然 后 转化 成 Bitmap 对 象 返 


网 


片 保存 到 SdCard 中 去 ， 下 面 我 们 来 分 析 这 两 个 方法 的 逻辑 。 


回 


。 此 方法 可 读 取 指定 路 径 下 的 文件 构造 Bitmap 对 象 ， 可 参考 表 7-8。 


保存 图 片 的 逻辑 比较 复杂 。 首 先 ， 使 用 getFreeSpace 判 断 SdCard 的 可 
Java 类 包 中 的 FileOutputStream 对 象 来 保存 | 


D 


用 空间 ， 若 空间 不 足 则 记录 日 志 信息 并 返回 空 ， 然 后 ， 判 断 


片 目录 是 否 存在 ， 如 果 不 存在 则 自动 创建 目录 ; 最 后 ， 就 是 使 用 
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片 到 sdCard 的 空间 上 去 。 这 里 面 用 到 了 许多 与 文件 操作 相关 的 Java 类 ， 大 家 可 以 参考 代码 注释 ， 好 好 学 习 和 理解 。 


通过 前 面 内 容 的 学 习 ， 我 们 发 现在 Android 系 统 中 处 理 图 片 离 不 开 Bitmap 和 BitmapFactory 等 图 像 类 。 这 些 类 库 虽 然 很 方便 ， 但 是 在 使 用 的 过 程 中 我 们 还 必须 注意 图 片 过 大 可 能 导致 的 内 存 溢出 。 比 
如 ， 使 用 BitmapFactory 中 的 方法 构造 Bitmap 时 就 有 可 能 遇 到 这 个 问题 ， 特 别 是 当 图 片 大 于 1MB 的 情况 下 ， 导 致 这 个 问题 的 原因 是 Android 系 统 在 处 理 图 片 的 时 候 使 用 了 堆 内 存 ， 而 堆 内存 被 应 用 程序 分 配 


的 内 存 限制 ， 因 此 当 处 理 的 
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片 过 大 时 ， 很 有 可 能 造成 应 用 程序 内 存 耗 尽 而 导致 的 内 存 溢出 错误 。 


[ 


解决 这 个 问题 有 两 个 方向 ， 一 方面 在 准备 图 片 资源 的 时 候 我 们 需要 进行 压缩 ， 在 效果 可 接受 的 范围 内 ， 保 证 


网 


片 尽 可 能 的 小 ; 另 一 方面 就 是 在 解码 (decode) 的 时 候 对 图 片 进行 无 损 的 等 比例 缩放 ， 这 


个 需要 用 到 BitmapFactory.Options 类 中 的 inJustDecodeBounds 属 性 ， 该 
家 可 以 参考 注释 来 理解 。 


代码 清单 7-72 


public static Bitmap getSampleBitmap (String imageFilePath) { 
float sampleSize = 100; 
BitmapFactory.Options options = new BitmapFactory.Option: 
options. inJustDecodeBounds = true; 
// 获取 原始 图 片 的 帘 和 高 (inJustDecodeBounds 必 须 为 true) 


属性 为 true 时 可 获取 到 图 像 的 原始 大 小 信息 ， 然 后 计算 出 合适 的 缩放 尺寸 ， 最 后 再 进行 解码 处 理 。 使 用 范例 见 代码 清单 7-72， 大 


s(); 


Bitmap bitmap = BitmapFactory.decodeFile (imageFilePath, options); 


// 如 果 图 片 存在 

if (bitmap != null) ( 
// 获取 原始 大 小 
float oWidth = options.outWidth; 
float oHeight = options.outHeight; 
// 计算 缩放 比例 


int scale = (int) ((oHeight > oWidth ? oHeight : oWidth) / sampleSize); 


if (scale <= 0) { 
scale = 1; 
} 
options.inSampleSize = scale; 
options.inJustDecodeBounds = false; 
// 解码 图 片 (inJustDecodeBounds 必 须 为 false) 


bitmap = BitmapFactory.decodeFile (imageFilePath, options); 


} 
return bitmap; 


} 


777 ”使 用 SQLite 绥 存 数据 


通过 7.7.1 节 中 对 Uilndex 类 代码 的 分 析 ， 我 们 了 解 到 在 网 络 请 求 失败 的 情况 下 ， 程 序 还 需要 从 SQLite 数 据 库 中 获取 保存 的 微 博 信息 ， 也 就 是 onNetworkError 方 法 中 的 逻辑 。 其 中 最 关键 的 就 是 
BlogSqlite 类 中 的 getAllBlogs 方 法 ， 该 方法 用 于 从 SQLite 数 据 库 中 获取 存储 的 微 博 列 表 信息 。 要 搞 清 楚 这 部 分 功能 的 实现 方法 ， 首 先 需 要 介绍 微 博 客户 端 框 架 中 的 数据 库 基 类 BaseSqlite， 是 对 


SQLiteOpenHelper 助 手 类 的 封装 ， 实 现 了 数据 库 操 作对 象 的 CRUD 标 准 接 


。BaseSqlite 类 在 com.app.demos.base 包 下 的 BaseSqlite.java 文 件 中 ， 我 们 将 该 类 的 主要 方法 简介 如 下 。 


- create (ContentValues values) : 保存 数据 至 数据 库 表 ， 该 方法 只 需 传 入 ContentValues 格 式 的 插入 数据 即 可 ，ContentValues 是 一 种 键 值 对 数据 ， 通 常用 于 Android 应 用 数据 存储 的 相关 功能 之 中 。 


- update (ContentValues values, String where, String[]params) : 更 新 数据 库 表 行 ， 该 方法 除了 需要 传 入 ContentValues 格 式 的 键 值 对 数据 之 外 ， 还 需要 传 入 更 新 条 件 的 where 语 句 以 及 where 参 


: delete (String where, String[]params) : 删除 数据 库 表 行 ， 该 方法 只 需要 传 入 删除 条 件 的 where 语 和 句 以 及 where 参 数 即 可 。 
- query (String where, String[]params) : 返回 数据 库 查 询 结果 的 数据 集 ， 该 方法 需要 传 入 查询 条 件 的 where 语 句 以 及 where 参 数 。 另 外 ， 它 返回 的 数据 集 是 ArrayList 类 型 的 ， 可 直接 使 用 。 
: count (String where, String[]params) : 返回 查询 结果 集 的 大 小 (int 型 数值 ) ， 该 方法 需要 传 入 查询 条 件 的 where 语 句 以 及 where 参 数 。 


: exists (String where, String[]params) : 返回 查询 成 功 或 者 失败 (boolean 型 数值 ) ， 该 方法 需要 传 入 查询 条 件 的 where 语 句 以 及 where 参 数 。 


除了 以 上 的 基础 数据 库 操作 方法 之 外 ， 该 抽象 类 还 定义 了 几 个 抽象 方法 ， 用 于 返回 子 类 对 应 数据 库 表 的 配置 ， 方 法 简介 如 下 。 


: String tableName: 返回 数据 表 名 。 
- String[ltableColumns: 返回 数据 表 的 字段 集合 
: String createSql: 返回 数据 表 的 创建 语句 


- String upgradeSql: 返回 数据 表 的 更 新 语句 。 


接着 介绍 BaseSqlite 类 的 使 用 方法 ， 这 里 的 微 博 数据 操作 类 BlogSqlite 恰 好 可 以 作为 该 数据 库 基础 类 的 使 用 范例 。BlogSqlite 类 的 完整 代码 如 代码 清单 7-73 所 示 。 


代码 清单 7-73 


package com.app.demos.sqlite; 
import java.util.ArrayList; 
import android.content.ContentValues; 
import android.content.Context; 
import com.app.demos.base.BaseSqlite; 
import com.app.demos.model.Blog; 
public class BlogSqlite extends BaseSqlite { 
public BlogSqlite (Context context) { 
super (context); 
} 
GOverride 
protected String tableName() ( 
return "blogs"; 
} 
GOverride 
protected String[] tableColumns() { 
String[] columns = ( 
Blog.COL ID, 
Blog.COL FACE, 
Blog.COL CONTENT, 
Blog.COL | ; COMMENT, 
Blog.COL AUTHOR, 
Blog. COL 1 UPTIME 
Ë 
return columns; 


} 


GOverride 
protected String createSql() ( 
return "CREATE TABLE " + tableName() + " ("+ 

Blog.COL ID + " INTEGER PRIMARY KEY, " + 
Blog.COL FACE + " TEXT, " + 
Blog.COL CONTENT + " TEXT, " + 
Blog.COL COMMENT + " TEXT, " + 
Blog.COL AUTHOR E RST Up 
Blog.COL_UPTIME + " TEXT" + 
my my 

} 

GOverride 


protected String upgradeSql() { 
return "DROP TABLE IF EXISTS " + tableName(); 
} 
public boolean updateBlog (Blog blog) { 
// 准备 数据 
ContentValues values = new ContentValues () 7 
values.put (Blog.COL ID, blog.getId()); 
values.put (Blog.COL FACE, blog.getFace()); 
values.put (Blog.COL í ; CONTENT, blog.getContent ( 
values.put(Blog.COL COMMENT, blog.getComment ( 
values.put (Blog. COL 1 ; AUTHOR, blog.getAuthor()); 
values. RAT COL UPTIME, blog.getUptime()); 
// 准备 SQL 语 
String heri = Blog.COL ID + "=?"; 
String[] whereParams = new String[] {blog.getId()}; 
/ /创建 或 更 新 
try { 
if (this.exists (whereSql, whereParams)) { 
this.update (values, whereSql, whereParams); 
) else ( 
this.create (values); 
š 
} catch (Exception e) { 
e.printStackTrace () ; 
return false; 
} 
return false; 
$ 
public ArrayList<Blog> getAllBlogs () { 
ArrayList<Blog> blogList = new Arraylist<Blog>(); 
try { 
ArrayList<ArrayList<String>> rList = this.query (null, null); 
int rCount = rlist.size(); 
for (int i = 0; i < rCount; i++) í 
ArrayList<String> rRow = rlist.get(i); 
Blog blog = new Blog () ; 
blog.setId(rRow.get(0)); 
blog.setFace (rRow.get (1) ) ; 
blog.setContent (rRow.get ( 
blog.setComment (rRow. get ( 
blog.setAuthor (rRow.get (4 
blog.setUptime (rRow.get (5 
blogList.add (blog); 


SITO 


š 
} catch (Exception e) ( 
e.printStackTrace () ; 
} 
return blogList; 


从 上 述 代码 中 ， 我 们 看 到 BlogSsqlite 类 实现 了 其 基 类 (BaseSqlite) 中 的 tableName、tableColumns、createSql 和 upgradeSql 四 个 抽象 方法 ,分别 用 于 返回 表 名 、 表 字段 、 表 创建 语句 以 及 表 更 新 语 
句 。 从 这 些 方法 的 逻辑 中 我 们 可 以 看 出 微 博 列表 的 数据 表 名 是 blogs， 该 表 有 6 个 字段 ， 包 括 微 博 ID (Blog.COL ID) 、 用 户头 像 (Blog.COL FACE) 以 及 微 博 内 容 (Blog.COL CONTENT) 等 ， 而 这 些 字 
段 名 与 Blog 模 型 对 象 中 字段 是 一 一 对 应 的 。 当 然 ， 该 类 也 继承 了 Basesqlite 中 的 CRUD 方 法 ， 除 此 之 外 Blogsqlite 中 还 实现 了 updateBlog 和 getAllBlogs 两 个 方法 ， 分 别 用 于 保存 和 获取 SQLite 数 据 库 中 的 微 


博 数据 ; 这 两 个 方法 可 以 在 微 博 列表 界面 控制 器 类 Uilndex 中 的 onTaskComplete 和 onNetworkError 方 法 中 找到 ， 也 就 是 说 程序 会 在 成 功 获取 微 博 列表 信息 的 时 候 保存 数据 ， 然 后 在 网 络 出 现 问题 的 时 候 把 


这 些 离线 数据 读 取出 来 


至 此 ， 


些 零散 的 知识 点 结合 起 来 思考 和 理解 ， 不 仅 可 以 对 如 何 灵活 运 


于 显示 。 


微 博 列表 界面 中 的 主 


知识 都 已 经 介绍 完了 ， 本 界面 中 包含 了 Android 应 


7.8 ”我 的 微 博 列表 


顾名思义 ， 我 的 微 博 列表 界面 
界面 比较 相似 ， 相 关 的 知识 也 可 以 在 7.7 节 中 学 到 ， 不 过 本 界 


7.8.1 


我 的 微 博 列表 界面 可 大 致 分 为 两 部 分 ， 上 方 的 
不 过 传递 的 参数 略 有 不 同 。 我 的 微 博 列表 界面 对 应 的 


于 


户 自己 所 写 的 微 博信 息 ， 该 界面 的 入 口 


EAN 


UI 控件 变 得 更 有 心得 ， 还 可 以 拓 


是 底部 的 功能 选项 栏 从 左 往 右 数 的 第 二 个 选项 按钮 。 在 我 的 微 博 列表 界面 中 ， 许 多 功能 逻辑 和 UI 控 件 的 有 


Ë 


界面 程序 逻辑 


编程 中 许多 重要 的 知识 和 技巧 ， 都 是 我 们 需要 重点 掌握 的 内 容 。 建 议 大 家 可 以 重新 
展 Android 应 用 开发 的 思路 。 


中 我 们 还 是 可 以 学 到 不 少 与 ListView 以 及 ScrollView 相 关 的 知识 和 技巧 。 


户 信息 和 下 方 的 微 博 列 表 。 我 的 


代码 清单 7-74 


户 信息 从 服务 端的 查看 


户 信息 接口 


界面 控制 器 类 是 UiBlogs， 该 类 的 逻辑 实现 如 代码 清单 7-74 所 示 。 


获取 ;而 微 博 列 表 数 据 则 是 从 微 博 列表 接口 


回 


顾 Uilndex 类 中 的 代码 逻辑 ， 把 这 


法 与 微 博 列表 


中 获得 的 ， 和 微 博 列表 界面 类 似 ， 只 


package com.app.demos.ui; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


java.util.ArrayList; 
java.util.HashMap; 
com.app.demos.R; 
com.app.demos. 
com.app.demos. 
com.app.demos. 
com.app.demos. 
com.app.demos. 
com.app.demos. 
com.app.demos. 
com. app. demos .model .Blog; 
com. app . demos .model . Customer; 
com.app.demos.util.AppCache; 
com.app.demos.util.AppUtil; 
com.app.demos.util.UIUtil; 
android.graphics.Bitmap; 
android.os.Bundle; 
android.os.Message; 
android.view.KeyEvent; 
android.view.View; 
android.widget.ImageButton; 
android.widget.ImageView; 
android.widget.LinearLayout; 
android.widget.TextView; 
class UiBlogs extends BaseUiAuth { 
private ImageView faceImage; 
private String faceImageUrl; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.ui blogs); 
// 设置 界面 消息 处 理 器 
this.setHandler (new BlogsHandler (this) ); 
// 设置 底部 选项 效果 


.BaseHandler; 
-BaseMessage; 
.BaseTask; 
.BaseUi; 
.BaseUiAuth; 
“Ci 
list.ExpandList; 


ImageButton ib = (ImageButton) this.findViewById(R.id.main tab 2); 


ib.setImageResource (R.drawable.tab heart 2); 
} 
GOverride 
public void onStart () ( 
super.onStart (); 
// 获取 微 博 用 户 信息 
HashMap<String, String> cvParams 
cvParams.put("customerId", customer.getId()); 


new HashMap<String, String>(); 


this.doTaskAsync (C.task.customerView, C.api.customerView, cvParams) ; 


// 获取 微 博 列表 信息 

HashMap<String, String> blogParams 
blogParams.put("typeId", "1"); 
blogParams.put("pageId", "0"); 


new HashMap<String, String»(); 


this.doTaskAsync(C.task.blogList, C.api.blogList, blogParams); 
} 
//////////////////////////////////////////////////////////////////////////// 


// 异步 回调 方法 (这些 方 法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 
GOverride 
GSuppressWarnings ("unchecked") 
public void onTaskComplete (int taskId, BaseMessage message) { 
super.onTaskComplete (taskId, message); 
switch (taskId) ( 
// 用 户 信息 显示 
case C.task.customerView: 
try ( 


final Customer customer 
TextView textName 
(R.id.app blogs text customer name); 
TextView textInfo = (' 
(R.id.app blogs text customer info); 
textName.setText (customer.getSign()); 


(TextView) this.findViewById 


textInfo.setText (UIUtil.getCustomerInfo(this, customer)); 


// 异步 加 载 微 博 头像 
faceImage 
app blogs image face); 

faceImageUrl = customer.getFaceurl(); 
loadImage (faceImageUrl); 

} catch (Exception e) { 

e.printStackTrace () 
toast (e.getMessage ( 


)); 
} 
break; 

// 微 博 列表 显示 

case C.task.blogList: 
try { 


final ArrayList<Blog> blogList 
message .getResultList ("Blog"); 
String[] from = { 
Blog.COL_CONTENT, 
Blog.COL UPTIME, 
Blog.COL COMMENT 
J; 
int[] 


to 
R.id.tpl_list_blog_text content, 
R.id.tpl_list_blog_text_uptime, 
R.id.tpl_list_blog_text_comment 


}; 
// 这 里 我 们 使 用 expandlist 控 件 来 完成 


(ImageView) this.findViewById(R.id. 


(ArrayList<Blog>) 


(Customer) message.getResult ("Customer") ; 
(TextView) this.findViewById 


ExpandList el = new ExpandList (this, AppUtil.dataToList (blogList, 
from), R.layout.tpl list blogs, from, to); 
LinearLayout layout = (LinearLayout) this.findViewById 


(R.id.app blogs list view); 
layout.removeAllViews(); // 先 清除 ， 再 填充 
el.setDivider (R.color.divider3) ; 
el.setOnItemClickListener (new ExpandList 


OnItemClickListener() { 
GOverride 
public void onItemClick(View view, int pos) { 
Bundle params = new Bundle(); 
params .putString("blogId", blogList.get (pos) .getId()); 
overlay (UiBlog.class, params); 
} 
n; 
el.render (layout); 
} catch (Exception e) { 
e.printStackTrace(); 
toast (e.getMessage () ) ; 
} 
break; 
} 
l 
GOverride 
public void onNetworkError (int taskId) { 
super.onNetworkError (taskId); 


} 
HL BB MEL PL P gg gBgM PHP P MP M LH P P g M HH M LH P P P Pg P P HL LL G T 
// 界面 按键 控制 


GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode 一 KeyEvent.KEYCODE BACK && event.getRepeatCount() 一 0) ( 


this.forward(UiIndex.class); 


} 


return super.onKeyDown (keyCode, event); 


} 
//////////////////////////////////////////////////////////////////////////// 
// 自 定义 消息 处 理 类 
Private class BlogsHandler extends BaseHandler { 
public BlogsHandler (BaseUi ui) { 
super (ui); 
} 
GOverride 
public void handleMessage (Message msg) ( 
super.handleMessage (msg) ; 
try { 
switch (msg.what) ( 
case BaseTask.LOAD IMAGE: 
Bitmap face = AppCache.getImage (faceImageUrl); 
faceImage.setImageBitmap (face); 
break; 
} 
} catch (Exception e) { 
e.printStackTrace () ; 
ui.toast (e.getMessage () ) ; 


我 们 仅 对 代码 中 比较 重要 的 方法 逻辑 进行 剖析 和 归纳 。 


UiBlogs 类 也 继承 自 登录 界面 控制 类 BaseUiAuth， 该 类 的 代码 比较 长 、 涉 及 的 知识 点 也 比较 多 ， 下 


Ej 


1.onCreate 方 法 


片 的 异步 加 载 逻 辑 ， 类 似 于 微 博 列表 界面 控制 器 类 Uilndex 中 的 IndexHandler， 但 是 功能 逻辑 却 大 不 


同样 是 进行 界面 的 初始 化 ， 需 要 注意 的 是 这 里 设置 了 自 定义 消息 处 理 类 BlogsHandler， 用 于 处 理 
相同 ， 稍 后 我 们 会 单独 介绍 ( 见 第 4 点 ) 。 


[D 


2.onStart 方 法 


同样 是 在 这 里 处 理 异 步 任 务 ， 不 过 这 里 同时 创建 了 两 个 异步 任务 ， 即 从 查看 用 户 信息 接口 ( 见 6.3.3 节 ) 获取 我 的 用 户 信息 和 从 微 博 列表 接口 中 获取 我 的 微 博 列表 信息 ， 这 两 个 任务 的 ID 分 别 是 
C.task.customerView 和 C.task.blogList 常 量 ， 请 求 的 服务 端 API 地 址 分 别 是 C.api.customerView 和 C.api.blogList 常 量 。 


3.onTaskComplete 方 法 


处 理 异步 任务 完成 之 后 的 逻辑 ， 准 确 来 说 应 该 是 根据 获得 的 任务 ID 来 分 别处 理 我 的 用 户 信息 的 展示 ， 以 及 我 的 微 博 列表 信息 的 显示 。 需 要 注意 的 是 ， 我 的 用 户 信息 是 对 象 数据 ， 故 使 用 BaseMessage 的 


getResult 方 法 来 获取 ; 而 我 的 微 博 列 表 是 对 象 列 表 数 据 ， 故 使 用 BaseMessage 的 getResultList 来 获取 。 该 界面 的 控件 元 素 比较 复杂 ， 所 以 我 们 会 使 用 ScrollView 结 合 ListView 的 方式 来 实现 ， 具 体 请 参考 
7.8.2 节 的 内 容 。 
4.BlogsHandler 类 


此 类 用 于 处 理 异步 加 载 图 片 的 逻辑 ， 这 里 就 是 把 之 前 获取 到 的 图 片 地 址 设置 成 微 博 作者 的 用 户头 像 ， 与 微 博 列表 中 的 IndexHandler 是 不 一 样 的。 当然 ， 这 两 个 类 都 继承 自 BaseHandler 基 类 ， 也 支持 基 
类 中 的 所 有 消息 处 理 逻 辑 。 类 似 的 用 法 将 被 广泛 地 应 用 到 其 他 的 功能 界面 中 ， 当 然 每 个 界面 的 消息 处 理 器 类 中 的 逻辑 都 是 不 一 样 的 ， 这 也 是 为 什么 我 们 为 每 个 界面 控制 器 类 定义 各 自 独立 的 Handler 消 息 处 
理 器 类 的 原因 。 


至 此 ， 我 的 微 博 列表 界面 的 程序 逻辑 已 经 介绍 完毕 。 下 面 是 我 的 微 博 列表 界面 的 模板 文件 ui_blogs.xml， 如 代码 清单 7-75 所 示 。 


代码 清单 7-75 


<?xml version-"1.0" encoding-"utf-8"?» 
«merge xmlns:androide"http://schemas.android.com/apk/res/android"» 
«include layout-"(layout/main layout" /> 
<LinearLayout T 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"> 
<include layout="@layout/main top" /> 
<ScrollView W 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:scrollbars-"vertical" 
android:layout weight-"1" 
android:fillViewport-"true"» 
<LinearLayout 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
<AbsoluteLayout 
android: layout_width="fill parent" 
android: layout _height="55dip"> 
<ImageView o 
android:id="@+id/app_ blogs image face" 
android:layout width-"50dip" T 
android:layout height-"50dip" 
android:layout margin-"5dip" 
android:layout alignParentRight-"true" 
android: srce="@drawable/face" 
android: focusable="false" 
android: layout_x="5dip" 
android: layout_y="5dip"/> 
<TextView T 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout margin-"5dip" 
android:id-"8«id/app blogs text customer name" 


android:textStyle="bold" 
android:text="name" 
android: layout_x="60dip" 
android: layout_y="10dip"/> 
<TextView ix 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout margin-"5dip" 
android "é*id/app blogs text customer info" 
android: 
android: 
android: 
</AbsoluteLayout> 
<LinearLayout 
android: id="@+id/app_ blogs list view" 
android:orientation-"vertical" 7 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout marginLeft-"5dip" 
android:layout marginRight-"5dip" 
android:background="@drawable/body_1" 
android: layout_gravity="center"> 
</LinearLayout> ~ 
</LinearLayout> 
«/ScrollView» 
«include layout-"G(layout/main tab" /> 
</LinearLayout> > 
</merge> 


我 的 微 博 列表 界面 的 显示 效果 如 图 7-21 所 示 。 
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7.82 ”使 用 ScrollView 


图 7-21 我 的 微 博 列 表 界 面 运 行 效果 


ScrollView 即 滚动 视 医 


， 可 被 用 作 容 器 来 容纳 其 他 的 UI 元 素 。ScrollView 类 位 于 android.widget 包 下 ， 继 承 自 ViewGroup， 下 面 是 ScrollView 类 的 继承 关系 。 


java.lang.Object 


|- android.view.View 
|- android.view.ViewGroup 
|- android.widget.FrameLayout 
|- android.widget.ScrollView 


从 ScrollView 类 的 继承 关系 可 以 看 出 滚动 视 


[D 


与 其 他 的 UI 控件 不 大 一 样 ， 因 为 它 继承 自 FrameLayout， 可 见 滚动 视图 


是 “滚动 控件 ”的 原因 。 我 们 把 ScrollView 视 图 特有 属性 的 使 用 方法 以 及 属性 对 应 的 操作 方法 总 结 在 表 7-9 中 。 


表 7-9 ScrollView 视 


特有 属性 


法 更 类 似 于 界面 布局 ， 这 也 是 为 何 我 们 把 ScrollView 称 为 “滚动 视图 ”而 不 


属性 名 


操作 方法 


使 用 说 明 


android:fillViewport setFillViewport(boolean) 


ScrollView 中 含有 大 小 可 伸缩 的 控件 时 ， 是 否 让 控件 填 
满 屏 幕 ， 比 如 内 部 包含 Listview 的 情况 


android:scrollbars 
android:scrollbarSize 


是 否 显示 深 动 条 
滚动 条 大 小 


android:scrollbarStyle 


en en [en 


滚动 条 样式 ， 包 括 insideOverlay、insideInset、outside- 
Overlay 和 outsideInset 四 种 


由 于 我 的 微 博 列表 界面 并 不 是 一 个 单纯 的 列表 ， 还 包含 顶部 的 用 户 信 息 以 及 一 些 特殊 的 界面 样式 ， 
码 可 参考 ui_blogs.xml 模 板 的 内 容 ( 见 代码 清单 7-75) 。 


因此 无 法 简 和 


地 使 


ListView 来 实现 ， 这 里 我 们 采用 了 ScrollView 加 上 ListView 的 方式 来 实现 ， 实 现代 


从 ui_blogs.xml 的 模板 代码 中 可 以 看 出 ， 我 的 微 博 列表 界面 外 框 就 是 一 个 ScrollView， 里 面 谋 套 了 一 个 完全 撑 开 的 线性 布局 (LinearLayout) ， 而 这 个 线性 布局 中 又 包含 了 一 个 绝对 布局 


(AbsoluteLayout) 和 另 一 个 线性 布 


局 (LinearLayout) ， 分 别 用 于 包含 顶部 的 用 户 信息 以 及 下 方 的 微 博 列表 。 以 上 的 控件 元 素 就 大 致 构成 了 我 的 微 博 列 表 的 整体 界面 。 


看 到 这 里 ， 一 些 朋 友 也 许 会 有 疑问 ， 在 ui_blogs.xml 中 没有 看 到 任何 的 ListView 控 件 ， 那 如 何 来 展示 微 博 列表 呢 ? 通过 分 析 ， 我 们 会 发 现 id 为 app_blogs list_view 的 线性 布局 成 为 显示 微 博 列表 的 “ 列 
表 控 件 ”。 在 接 下 来 的 7.8.3 节 中 ， 我 们 将 详细 介绍 这 种 自 定义 的 列表 控件 是 怎么 实现 的 。 


7.8.3 ”使 用 自 定义 微 博 列表 


诚然 ， 在 Android 系 统 中 ，Ul 框 架 所 提供 ListView 控 件 是 我 们 展示 列表 型 数据 的 首选 ， 但 绝 不 是 唯一 的 选择 ， 特 别 对 于 一 些 复杂 的 应 用 界面 来 说 ， 我 们 往往 需要 把 许多 的 控件 混合 起 来 使 用 ， 在 这 种 情 
况 下 ，ListView 控 件 使 用 起 来 就 不 是 很 方便 了 ， 甚 至 有 可 能 遇 到 一 些 兼 容 性 的 问题 。 于 是 ， 我 们 就 考虑 是 否 能 自己 实现 一 个 ListView 呢 ?答案 是 肯定 的 ，com.app.demos.list 包 中 的 ExpandList 类 就 是 一 个 


代码 清单 7-76 


自 定义 的 ListView， 我 们 先 来 看 该 类 的 代码 ， 如 代码 清单 7-76 所 示 。 


package com.app.demos.list; 
import java.util.List; 


import java.util.Map. 
import com.app.demos 
import com.app.demos 


RR; 
.util.AppFilter; 


import android.content.Context; 

import android.view.LayoutInflater; 

import android.view.View; 

import android.view.ViewGroup; 

import android.view.ViewGroup.LayoutParams; 

import android.widget.TextView; 

public class ExpandList { 
private LayoutInflater layout - null; 
private Integer dividerId - R.color.dividerl; 
private ExpandList.OnItemClickListener itemClickListener - null; 
private Context context - null; 


private List«? 


extends Map<String, ?>> dataList = null; 


private int resourceld - -1; 


private String 


[] dataKeys = (); 


private int[] tplKeys - (); 
public ExpandList (Context context, List<? extends Map<String, ?>> data, int 
resource, String[] from, int[] to) ( 


// 布局 相 


关 属 性 


this.context = context; 
this.layout = LayoutInflater.from(context) ; 


// 数据 相 


关 属 性 


this.resourceId = resource; 
this.dataList = data; 
this.dataKeys = from; 
this.tplKeys = to; 


} 
public View getView () { 
return layout.inflate (resourceId, null); 


} 
public void setDivider (Integer dividerId) { 
this.dividerId = dividerId; 


} 


public void setOnItemClickListener (ExpandList.OnItemClickListener listener) { 
itemClickListener = listener; 


f 
public void render (ViewGroup vg) { 
int dataPos = 0; 
int dataSize = datalist.size(); 
// 按 数据 列表 循环 
for (Map<String, ?> data : datalist) { 
View v = getView(); 


// 


展示 列表 项 字段 


for (int i = 0; i < dataKeys.length; i++) { 


} 
// 
if 


String dataKey = dataKeys[i]; 

int tplKey = tplKeys[i]; 

TextView tv = (TextView) v.findViewByld(tplKey); 
AppFilter.setHtml (tv, data.get (dataKey).toString()); 


添加 事件 监听 器 
(itemClickListener != null) { 
final int pos = dataPos; 
v.setOnClickListener (new View.OnClickListener() { 
GOverride 


public void onClick(View v) { 
itemClickListener.onItemClick(v, pos); 
} 
D; 
} 
vg.addView (v); 
// 数据 项 位 置 
dataPos++; 
// 展示 分 割 线 
if (dataPos < dataSize) { 
View d = new TextView (context, null); 
d.setBackgroundResource (dividerId) ; 
d.setLayoutParams (new LayoutParams (ViewGroup.LayoutParams.FILL PARENT, 1)); 
vg.addView (d); ~ 
} 
F 


l 
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// 自 定义 事件 监听 器 
abstract public interface OnItemClickListener { 
abstract public void onItemClick(View view, int pos); 


) 


从 上 述 代 码 中 ， 我 们 注意 到 ExpandList 类 并 未 继承 任何 类 ， 完 全 是 独立 实现 的 ， 我 们 也 可 以 把 它 当做 是 UI 控 件 的 综合 使 用 示例 来 学 习 ， 下 面 我 们 将 对 代码 中 比较 重要 的 知识 点 进行 剖析 和 归纳 。 


1 .构造 方法 


从 构造 方法 的 参数 可 以 看 出 ，ExpandList 的 设计 思路 与 SimpleAdapter 类 似 ， 有 关 SimpleAdapter 的 用 法 请 参考 7.7.2 节 中 对 系统 常用 适配器 的 介绍 。5 个 参数 分 别 是 上 下 文 对 象 (context) 、 列 表 数 据 
(data) 、 模 板 ID (resource) 、 数 据 项 字段 数组 (from) 以 及 数据 项 对 应 控件 ID 的 数组 (to) 。 


2.getView 方 法 


获取 列表 项 的 模板 对 象 ， 与 前 面 介绍 的 BlogList 类 相似 ， 都 使 用 布局 对 象 Layoutlnflater 中 的 inflate 方 法 来 获取 。 


3.setDivider 方 法 


设置 列表 分 割 线 图 形 的 资源 ID， 而 其 他 适配器 类 中 的 setDivider 方 法 的 参数 却 是 Drawable 对 象 。 另 外 ，ExpandList 中 默认 是 没有 分 割 线 的 。 


4.setOnltemClickListener 方 法 


每 个 列表 项 的 点 击 事件 监听 器 ， 该 方法 的 用 法 与 其 他 的 适配器 类 相同 ， 只 不 过 所 用 的 监听 器 的 类 型 有 些 不 同 ， 这 里 我 们 使 用 的 是 ExpandList 自 定义 的 内 部 类 ExpandList.OnltemClickListener。 


5.render 方 法 


演 染 并 展示 列表 ， 是 ExpandList 类 的 核心 逻辑 所 在 。 首 先 ， 该 方法 需要 传 入 列表 容器 的 View 对 象 ， 当 然 既 然 是 容器 该 对 象 类 型 就 必须 是 ViewGroup; 然后 ， 我 们 会 按照 列表 数据 来 循环 构建 每 个 列表 
项 的 View 对 象 ， 并 使 用 addView 方 法 添加 到 列表 容器 的 ViewGroup 对 象 中 去 ; 接着， 再 为 每 个 列表 项 设置 点 击 事件 监听 器 ; 最 后 ， 根 据 列 表 项 的 位 置 来 设置 分 割 线 。 


至 此 ， 我 们 已 经 完成 了 一 个 自 定义 的 列表 类 ExpandList， 该 类 可 以 使 用 任意 的 ViewGroup 为 容器 ， 使 用 起 来 非常 方便 。 另 外 ，ExpandList 使 用 最 基本 的 布局 控件 组 合 而 成 ， 兼 容 性 也 非常 的 好 。 在 我 的 
微 博 列表 界面 控制 器 UiBlogs 类 中 ， 我 们 可 以 在 onTaskComplete 方 法 里 找到 该 类 的 使 用 范例 ， 如 代码 清单 7-77 所 示 。 


代码 清单 7-77 


ExpandList el = new ExpandList(this, AppUtil.dataToList (blogList, from), R.layout.tpl list blogs, 
from, to); 
LinearLayout layout = (LinearLayout) this.findViewById(R.id.app blogs_list view); 
layout.removeAllViews(); // 先 清 空 列表 项 
el.setDivider (R.color.divider3) ; 
el.setOnItemClickListener (new ExpandList.OnItemClickListener() { 
GOverride 
public void onItemClick (View view, int pos) í 
Bundle params - new Bundle(); 
params.putString("blogId", blogList.get (pos) .getId()); 
overlay (UiBlog.class, params); 


) 


el.render (layout) ; 


从 以 上 代码 中 我 们 可 以 看 到 ， 该 界面 中 微 博 列表 的 容器 控件 是 ID 为 app_blogs list_view 的 线性 布局 ， 而 微 博 列表 项 的 模板 是 tpl list_blogs.xml， 与 微 博 列表 界面 的 tpl list_blog.xml 相 似 ， 唯 一 的 区 别 就 
是 少 了 用 户头 像 ， 因 此 不 再 歼 述 。 另 外 ， 我 们 还 使 用 了 ExpandList 对 象 的 setOnltemClickListener 方 法 来 设置 每 个 微 博 列表 项 点 击 之 后 所 要 执行 的 逻辑 代码 ， 通 过 代码 分 析 我 们 会 发 现 此 处 的 逻辑 和 微 博 列 
表 界 面 中 的 一 样 ， 都 是 使 用 overlay 方 法 打开 对 应 的 微 博 文章 界 


E 


79 MEERE 


微 博文 章 界面 用 于 展示 微 博 的 详细 内 容 ， 在 微 博 列表 界面 或 者 我 的 微 博 列表 界面 中 点 击 微 博 列表 中 的 单条 微 博 都 可 以 打开 该 界面 。 微 博文 章 界面 是 微 博 应 用 中 控件 元 素 最 为 丰富 的 界面 ， 我 们 将 以 该 界 
面 为 例 来 进一步 熟悉 Android UI 控件 的 使 用 技巧 。 


793 ”界面 程序 逻辑 


微 博文 章 界面 的 逻辑 包括 三 大 部 分 ， 项 部 的 微 博 用 户 信息 、 中 部 的 微 博文 章 以 及 底部 的 微 博 评论 列表 ， 数 据 来 源 对 应 的 服务 端 接口 分 别 是 查看 用 户 信息 接口 、 查 看 微 博 接口 以 及 评论 列表 接口 。 微 博文 
章 界 面 对 应 的 界面 控制 器 类 是 UiBlog， 该 类 的 逻辑 实现 如 代码 清单 7-78 所 示 。 


代码 清单 7-78 


package com.app.demos.ui; 

import java.util.ArrayList; 

import java.util.HashMap; 

import com.app.demos.R; 

import com.app.demos.base.BaseUi; 
import com.app.demos.base.BaseUiAuth; 
import com.app.demos.base.BaseHandler; 
import com.app.demos.base.BaseMessage; 
import com.app.demos.base.BaseTask; 
import com.app.demos.base.C; 

import com.app.demos.list.ExpandList; 
import com.app.demos.model.Blog; 
import com.app.demos.model.Comment; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


private Button addfansBtn 
private Button commentBtn 


com 
com 
com 
com 


.app.demos .mode1 .Customer; 
-app.demos .util.AppCache; 
.app.demos.util.AppUtil; 
.app.demos.util.UIUtil; 


android.graphics.Bitmap; 
android.os.Bundle; 
android.os.Message; 
android.view.KeyEvent; 
android.view.View; 
android.view.View.OnClickListener; 
android.widget.Button; 
android.widget.ImageView; 
android.widget.LinearLayout; 
android.widget.TextView; 

class UiBlog extends BaseUiAuth ( 
private String blogId - null; 
private String customerId - null; 


"ow d 
B 
E 
E 
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private ImageView faceImage = null; 


private String faceImageUrl 


GOverride 
public void onCreate (Bundle savedInstanceState) { 


} 


super.onCreate (savedInstanceState); 
setContentView(R.layout.ui blog); 
// 设置 界面 消息 处 理 器 
this.setHandler (new BlogHandler (this) ); 
// 获取 Intent 消 息 传 递 的 参数 
Bundle params = this.getIntent ().getExtras(); 
blogId = params.getString("blogId"); 
// bin s d E bk 
addfansBtn = (Button) this.findViewById(R.id.app blog btn addfans); 
addfansBtn.setOnClickListener (new OnClickListener() ( 
GOverride 
public void onClick(View v) ( 
// 从 服务 端 获取 对 应 博客 数据 
HashMap<String, String> urlParams = new HashMap<String, String>(); 
urlParams.put ("customerId", customerId) ; 
doTaskAsync (C.task.fansAdd, C.api.fansAdd, urlParams) 7 
} 


1; 
// 写 评论 按钮 点 击 膛 辑 
commentBtn = (Button) this.findViewById(R.id.app blog btn comment); 
commentBtn.setOnClickListener (new OnClickListener() ( 
GOverride 
public void onClick(View v) ( 
Bundle data - new Bundle(); 
data.putInt ("action", C.action.edittext.COMMENT); 
data.putString("blogId", blogId) ; 
doEditText (data) ; 
š 


1); 

// 获取 当前 微 博信 息 

HashMap<String, String> blogParams = new HashMap<String, String>(); 
blogParams.put ("blogId", blogId); 

this.doTaskAsync(C.task.blogView, C.api.blogView, blogParams) ; 


GOverride 
public void onStart () ( 


super.onStart (); 

// 获取 微 博 评论 列表 

HashMap<String, String> commentParams = new HashMap<String, String>(); 
commentParams.put ("blogId", blogId) 7 

comment Params .Put ("pageId", "0"); 

this.doTaskAsync (C.task.commentList, C.api.commentList, commentParams) ; 


l 
////////////////////////////////////////////////////////////////0//////////7/7/ 
// 异步 回调 方法 (这些 方 法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 

GOverride 

public void onTaskComplete(int taskId, BaseMessage message) { 


super.onTaskComplete (taskId, message); 
Switch (taskId) { 
// 当前 微 博信 息 显示 
Case C.task.blogView: 
try { 
Blog blog = (Blog) message.getResult ("Blog") ; 
TextView textUptime = (TextView) this. findViewById(R.id.app 
blog_text_uptime) ; T 
TextView textContent = (TextView) this.findViewById 
(R.id.app blog text content); 
textUptime.setText (blog.getUptime ()); 
textContent.setText (blog.getContent ()) ; 
Customer customer = (Customer) message.getResult ("Customer"); 
TextView textCustomerName = (TextView) this.findViewById 
(R.id.app blog text customer name); 
TextView testCustomerInfo = (TextView) this.findViewById 
(R.id.app blog text customer info); 
textCustomerName.setText (customer.getName ()) ; 
testCustomerInfo.setText (UIUtil.getCustomerInfo (this, customer)); 
// 设置 当前 用 户 ID， 供 其 他 逻辑 使 用 
customerId = customer.getId(); 
// 异步 加 载 微 博 头像 
faceImage = (ImageView) this.findViewById(R.id.app blog image face); 
faceImageUrl = customer.getFaceurl (); 
loadImage (faceImageUr1) ; 
} catch (Exception e) { 
e.printStackTrace () ; 
toast (e.getMessage () ) 7 
} 
break; 
// 徽 博 评论 列表 显示 
case C.task.commentList: 
try { 
@SuppressWarnings ("unchecked") 
ArrayList<Comment> commentList = (ArrayList<Comment>) 
message.getResultList ("Comment"); 
String[] from = { 
Comment.COL CONTENT, 
Comment.COL UPTIME 


int[] to = + 
R.id.tpl_list_comment_content, 
R.id.tpl_list_comment_uptime, 
H 
ExpandList el = new ExpandList(this, AppUtil.dataToList 
(commentList, from), R.layout.tpl list comment, from, to); 
LinearLayout layout = (LinearLayout) this.findViewById 
(R.id.app blog list comment); 
layout.removeAllViews (); // 先 清除 ， 再 填充 
el.render (layout) ; 
} catch (Exception e) { 
e.printStackTrace () ; 
toast (e.getMessage () ) ; 
} 
break; 
// 加 关注 提 
case C.task.fansAdd: 
if (message.getCode().equals("10000")) { 
toast("Add fans ok"); 
// 刷新 用 户 信息 (粉丝 数量 ) 
HashMap<String, String> cvParams = new HashMap<String, String>(); 
cvParams.put ("customerId", customerId); 
this.doTaskAsync(C.task.customerView, C.api.customerView, cvParams); 
) else ( 
toast ("Add fans fail"); 


} 
break; 
// 用 户 信息 显示 
Case C.task.customerView: 


try ( 
// 更 新 界面 上 的 用 户 信息 
final Customer customer = (Customer) message. 
getResult ("Customer") ; 
TextView textInfo = (TextView) this.findViewById 
(R.id.app blog text customer info); 
textInfo.setText (UIUtil.getCustomerInfo (this, customer)); 
] catch (Exception e) ( 
e.printStackTrace (); 
toast (e.getMessage () ) ; 
] 
break; 
} 
} 
GOverride 
public void onNetworkError (int taskId) ( 
super.onNetworkError (taskId); 


} 
//////////////////////////////////////////////////////////////////////////// 


// 其 他 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode 一 KeyEvent.KEYCODE BACK && event.getRepeatCount() = 0) { 
doFinish(); 


} 


return super.onKeyDown (keyCode, event); 


} 
人 AAA 
// 内 部 类 (以 下 BlogHandler 类 用 于 处 理 异步 动作 ) 
private class BlogHandler extends BaseHandler { 
public BlogHandler(BaseUi ui) { 
super (ui); 


} 
GOverride 
public void handleMessage (Message msg) ( 
super.handleMessage (msg) ; 
try ( 
switch (msg.what) ( 
case BaseTask.LOAD IMAGE: 
Bitmap face = AppCache.getImage (facelmageUrl); 
faceImage.setImageBitmap (face); 
break; 


) catch (Exception e) ( 


e.printStackTrace(); 
ui.toast (e.getMessage ()); 


UiBlog 类 也 继承 自 登录 界面 控制 类 BaseUiAuth， 该 类 的 代码 比较 长 、 涉 及 的 知识 点 也 比较 多 ， 下 面 我 们 仅 对 代码 中 比较 重要 的 方法 逻辑 进行 剖析 和 归纳 。 


1.onCreate 方 法 


微 博 文章 界面 的 初始 化 逻辑 相对 比较 多 。 首 先 ， 设 置 界面 消息 处 理 器 类 BlogHandler， 用 于 处 理 任务 消息 。 然 后 ， 从 Intent 消 息 中 获取 微 博 ID， 即 blogld 的 值 ， 该 值 是 通过 overlay 方 法 传递 过 来 的 。 之 
后 是 为 “加 关注 ”按钮 添加 点 击 事件 ， 点 击 该 按钮 时 将 触发 doTaskAsync 方 法 开启 一 个 异步 任务 ， 发 送 加 关注 的 用 户 ID 到 服务 端的 添加 粉丝 接口 (参考 6.3.4 节 ) 。 然 后 是 “ 写 评论 ”按钮 的 点 击 事件 ， 点 击 
该 按钮 将 触发 doEditText 方 法 切换 到 发 表 评论 界面 ， 这 点 我 们 将 在 7.9.3 节 中 详细 介绍 。 最 后 才 是 异步 访问 服务 端的 查看 微 博 接口 (参考 6.4.2 节 ) ， 显 示 微 博文 章 详 情 的 逻辑 。 


2.0nStart 方 法 


该 方法 中 仅 有 异步 访问 评论 列表 接口 (参考 6.5.2 节 ) 来 获取 评论 列表 的 逻辑 ， 该 逻辑 之 所 以 放 在 onstart 方 法 中 是 因为 用 户 在 发 表 评论 完毕 切换 回来 的 时 候 需要 重新 载 入 评论 列表 。 这 里 运用 到 Activity 
生命 周期 的 知识 ， 可 参考 2.3.1 节 中 的 内 容 。 


3.onTaskComplete 方 法 


处 理 异 步 任务 结束 后 的 界面 显示 逻辑 ， 该 界面 的 异步 任务 比较 多 ， 按 照 代 码 顺 序 依次 是 当前 微 博信 息 显示 、 微 博 评论 列表 显示 、 加 关注 提示 信息 以 及 用 户 信息 显示 的 逻辑 ， 下 面 我 们 来 简单 分 析 这 几 个 
步 任务 处 理 逻 辑 的 要 点 。 


: 当前 微 博 信息 显示 : 对 应 任务 ID 为 C.task.blogView。 查 看 微 博 接口 的 返回 比较 特殊 ， 既 包含 了 微 博文 章 的 详细 信息 ， 也 包含 了 微 博 作者 的 用 户 信息 ， 因 此 这 里 我 们 使 用 了 两 个 getResult 方 法 ， 分 别 用 于 
获取 Blog 和 Customer 对 象 数据 。 至 于 界面 控件 的 显示 和 浑 染 的 逻辑 和 之 前 介绍 的 都 差不多 ， 包 括 使 用 loadImage 异 步 加 载 头 像 图 片 等 ， 就 不 再 黄 述 了 。 


- 微 博 评论 列表 显示 : 对 应 任务 ID 为 C.task.comment-List。 和 我 的 微 博 列 表 界 面 一 样 ， 微 博文 章 界面 也 采用 了 ScrollView 加 上 ExpandList 的 方法 来 实现 ， 至 于 ExpandList 的 用 法 可 参考 7.8.3 节 的 内 容 ; MVE 
要 注意 的 是 当 评论 列表 刷新 的 时 候 需 要 使 用 removeAllViews 先 清除 所 有 列表 项 。 


: 加 关注 提示 信息 : 对 应 任务 ID 为 C.task.fansAdd。 由 于 添加 粉丝 接口 只 返回 消息 代码 ， 并 不 包含 数据 信息 ， 所 以 这 里 只 需要 通过 BaseMessage 的 getCode 方 法 获取 消息 代码 进行 判断 即 可 。 如 果 成 功 ， 即 消 
息 代 码 为 10000， 则 使 用 Toast 组 件 弹出 “Add fans ok” 的 提示 消息 。 另 外 ， 程 序 还 将 创建 一 个 获取 用 户 信息 的 异步 方法 来 刷新 微 博 作者 的 用 户 信息 。 


: 用 户 信息 显示 : 对 应 任务 ID 为 C.task.custometView。 该 任务 的 逻辑 比较 简单 ， 就 是 从 查看 用 户 信息 接口 获取 Customet 对 象 数 据 并 展示 到 界面 上 。 


至 此 ， 微 博文 章 界面 的 程序 逻辑 已 经 介绍 完毕 。 它 的 模板 文件 是 ui_blog.xml， 该 模板 文件 会 在 7.9.2 节 中 给 大 家 做 详细 分 析 。 最 后 ， 我 们 来 看 看 微 博 文章 界面 的 显示 效果 ， 如 图 7-22 所 示 。 
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写 评论 


7.9.2 ”界面 布局 进 阶 (综合 使 用 Ul 控件) 


前 面 刚 分 析 过 微 博文 章 界面 的 程序 逻辑 ， 也 了 解 到 该 界面 的 控件 元 素 相当 


7-22 微 博 文章 界面 运行 效果 


板 代码 ， 即 ui_blog.xml， 如 代码 清单 7-79 所 示 。 


代码 清单 7-79 


Fe (we 


7-22 所 示 ) ， 非 常 适合 作为 实例 来 帮助 大 家 学 习 和 理解 Android UI 控件 的 综合 使 用 。 接 着 我 们 就 来 分 析 该 界面 的 模 


<?xml version="1.0" encoding="utf-8"?> 
«merge xmlns:android="http: //schemas.android.com/apk/res/android"> 
<include layout="@layout/main_layout" /> 


<LinearLayout 


android: orientation="vertical" 


android: layout_widt! 
android: layout_height= 


fill parent" 
fill parent"» 


«include layout-"Qlayout/main top" /> 


<ScrollView 


android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android:scrollbars-"vertical" 
android: layout_weight="1" 
android: fillViewport="true"> 


<LinearLayout 


android: layout_widt! 


"fill parent" 


android:layout height-"fill parent" 
android:orientation-"vertical"» 
<RelativeLayout 

android: layout_width="fill parent" 


android: 


layout_height="60dip"> 


<ImageView 


android: i 
android: 
android: 
android: 
android: 
android: 
android: 


@+id/app blog image face 
layout width-"50dip" ` 
layout height-"50dip" 
layout margin-"5dip" 
src="@drawable/face" 
scaleType="fitxy" 
focusable="false"/> 


<TextView 


android: 
android: 
android 
android 
android 
android: 
android: 


layout width-"wrap content" 
layout height-"wrap content" 
layout marginTop-"8dip" 


:textStyle-"bold" 
text-"name" 


<TextView 


android: 
android: 
android: 
android: 
android: 
android: 


<Button 


android: 
android: 
android 
android 
android: 
android: 
android: 
android: 
android: 


layout width-"wrap content" 
layout height-"wrap content" 


text-"info" 


layout width-"80dip" 

layout height-"32dip" 
ackground="@drawable/button_1" 
="@+id/app_blog_btn_addfans" 
text="@string/btn_addfans" 
layout alignParentRight-"true" 
layout alignParentBottom-"true" 
layout marginRight-"8dip" 
layout marginBottom-"5dip"/» 


</RelativeLayout> 


<LinearLayout 


android: 
android: 
android: 
android: 
android: 
android: 
android: 


orientation-"vertical" 

layout width-"fill parent" 
layout height-"wrap content" 
layout marginLeft-"5dip" 
layout marginRight-"5dip" 
background="@drawable/body_1" 
layout_gravity="center"> 


<TextView 


android: 
android: 
android 
android: 
android: 
android: 
android: 
android: 


layout width-"fill parent" 
layout height-"wrap content" 
'é*id/app blog text content" 
layout margin-"5dip" 

layout gravity-"center" 
background-"4f6f6f6" 
padding-"10dip" 
textSize="12dip"/> 


<LinearLayout 


android: 
android: 
android: 
android: 
android: 


orientation="horizontal" 
layout_width="fill parent" 
layout_height="wrap_content" 
focusable="false" 

layout margin-"5dip"» 


<TextView 


android: 


layout_width="fill parent" 
android: 


layout_height="wrap_content" 
android: layout_weight="1" 
android:paddingLeft-"2dip" 
android:i 
android:textSize-"12dip" 
android:text-"loading" /» 


<TextView 


android: 
android: 


layout_width="fill parent" 
layout_height="wrap_content" 
android:layout_weight="2" ~ 
android: gravity="right" 
android:paddingRight="4dip" 

android: textSize="12dip 
android 


</LinearLayout> 
<LinearLayout 


android: 
android: 
android: 
android: 
android: 
android 
android: 


orientation: 
layout width-"fill parent" 
layout height-"wrap content" 
layout marginLeft-"5dip" 

layout marginRight-"5dip" 
ackground="@drawable/body 2" 
id="@+id/app blog list comment"» 


</LinearLayout> 


<Button 


android: layout_width= 
android:layout height 


"80dip" 
"32dip" 


android:background="@drawable/button_1" 
android: layout_marginLeft="5dip" 


android 
android 
android: i 


ayout_marginBottom="3dip" 
@+id/app_blog_btn_comment" 


android: 
android:text="@string/btn_comment" /> 
</LinearLayout> T 
</LinearLayout> 
</ScrollView> 


<include layout="@layout/main_tab" /> 


</LinearLayout> 
</merge> 


@+id/app_blog_text_uptime" 


:text-"Gstring/blog comment" /> 


i-"(-id/app blog text customer name" 


layout toRightOf="@+id/app blog image face"/» 


id-"(4id/app blog text customer info" 


layout toRightOf-"G*id/app blog image face" 
layout below="@+id/app blog text customer name"/» 


微 博文 件 界面 的 模板 代码 比较 长 ， 我 们 提取 其 代码 实现 中 的 几 个 引 


loading 


点 来 做 分 析 。 为 了 便于 理解 ， 我 们 将 该 界面 在 布 


局 编辑 器 中 的 预览 


图 


保存 到 


7-23 中 。 


1. 整 体 布局 


图 7-23 ” 微 博文 件 预览 界面 


从 图 7-23 中 我 们 可 以 清楚 得 看 出 微 博文 章 界面 的 布局 结构 ， 主 要 分 为 顶部 的 微 博 用 户 


信息 布 


面 类 似 的 ScrollView 加 上 可 扩展 列表 ExpandList 的 方式 。 另 外 ， 界 面 布局 主要 使 


了 线性 布 


(Button) 以 及 文本 框 控件 (TextView) 等 控件 ， 很 好 地 诠释 了 Android UI 控件 各 自 的 特点 和 组 合 使 用 的 方法 。 


2. 顶 部 布局 


顶部 的 微 博 用 户 信 息 布局 采 
数 ) ， 都 是 TextView 控 件 ; 最 右边 是 加 关注 按钮 的 Button 控 件 。 


3. 底 部 布局 


底部 的 微 博文 章 以 及 评论 列表 布局 采 


局 、 底 部 的 微 博文 章 以 及 评论 列表 布 
局 (LinearLayout) 加 上 相对 布 


局 。 整 个 界 | 


局 (RelativeLayout) 的 组 合 ， 


面 在 垂直 方向 是 可 伸缩 的 ， 这 里 也 采 
包含 了 图 像 控件 (ImageView) 、 按 钮 控件 


的 是 相对 布局 (RelativeLayout) ， 因 为 这 个 部 分 控件 的 排 布 相对 比较 不 规则 。 用 户头 像 的 ImageView 控 件 在 最 左边 ; 右边 是 有 


等 内 容 ; 特别 需要 注意 的 是 其 中 ID 为 app_blog_ list comment 的 LinearLayout 控 件 将 被 用 做 评论 列 
辐 片 ， 分 别 对 应 了 res/drawable/ 目 录 下 的 body 1.9.png 和 body_ 2.9.png， 这 种 用 法 可 以 参考 前 面 7.7.4 节 中 的 内 容 。 


户 名 和 | 


了 和 我 的 微 博 列表 界 


户 信息 (包括 微 博 数 和 粉丝 


至 此 ， 我 们 综合 


了 前 面 介绍 的 Android UI 界面 布局 以 及 实现 的 知识 和 技巧 ， 完 成 


了 微 博 应 上 


效果 如 图 7-22 所 示 。 


793 ”发 表 评论 功能 实现 


通过 7.9.1 节 中 对 微 博文 章 界面 程序 逻辑 的 分 析 ， 我 们 了 解 到 ， 当 上 


户 点 击 “ 写 评论 ”按钮 后 就 会 触发 doEditText 方 法 来 打开 微 博 应 


， 我 们 还 需要 注意 ， 布 


中 的 “ 


的 是 线性 布局 (LinearLayout) ， 原 因 是 这 个 部 分 的 控件 排 布 比较 规整 ， 大 臻 遵循 垂直 排列 的 布局 。 布 局 内 的 控件 大 部 分 都 是 TextView 
表 ExpandList 的 外 框 容器 。 另 多 


于 显示 微 博文 章 和 评论 


局 外 框 和 评论 列表 的 外 框 都 是 使 用 了 可 伸缩 的 背景 


中 最 复杂 的 界面 ， 即 微 博文 章 界面 。 我 们 可 以 看 到 该 界面 的 效果 是 非常 不 错 的 ， 程 序 进行 数据 填充 后 的 


”的 文本 编辑 界面 ， 


的 显示 效果 如 图 7-24 所 示 。 
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Le 


为 何 我 们 将 该 文本 编辑 界面 称 为 “通用 ”界面 ”原因 是 在 该 界 


面 中 处 理 的 逻辑 不 仅 只 有 发 表 评论 功能 ， 还 包括 微 博 应 


中 其 他 与 文本 编辑 有 关 的 功能 ， 比 如 用 户 配置 界面 的 修改 签名 功能 ( 见 7.10.3 


节 ) 理解 这 里 的 逻辑 实现 ， 先 要 从 BaseUi 基 类 中 对 doEditText 方 法 的 定义 开始 。 而 该 方法 的 


法 我 们 已 经 在 7.2.4 中 介绍 使 用 Intent 消 息 控制 界面 切换 的 时 候 给 大 家 讲 过 了 ， 逻 辑 实现 见 代码 清单 7-29 


所 示 。 实 际 上 doEditText 方 法 的 逻辑 很 简单 ， 就 是 发 出 一 个 Action 值 为 com.app.demos.EDITTEXT 


(Looper) 将 根据 应 用 配置 文件 ， 也 就 是 AndroidManifest.xml 文 件 中 的 配置 信息 来 决定 由 哪个 Activity 界 面 来 处 理 。 我 们 可 以 在 微 博 应 


7-80 所 示 。 


代码 清单 7-80 


<?xml version-"1.0" encoding-"utf-8"?» 


即 C.intent.action.EDITTEXT 常 量 的 值 ) 的 隐 性 消息 到 UI 线程 的 消息 队列 中 去 ， 而 消息 循环 部 件 
的 AndroidManifest.xml 文 件 中 找到 相关 的 配置 代码 ， 如 代码 清单 


«manifest http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...> 
<application http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15327/OEBPS/Text/...> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


<activity android:name=".ui.UiEditText" 
android: theme="@style/com.app.demos.theme. light" 
android: windowSoft InputMode="stateVisible|adjustResize" 
android: launchMode="singleTop"> 
<intent-filter> 
«action android:name-"com.app.demos.EDITTEXT" /> 
«action android:name-"android.intent.action.VIEW" /> 
«category android:name-"android.intent.category.DEFAULT" /» 
«/intent-filter» 
«/activity» 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


</application> 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


</manifest> 


从 以 上 配置 文件 的 声明 代码 中 可 以 看 出 ， 最 终 用 于 处 理 该 消息 的 Activity 界 面 控制 器 类 是 com.app.demos.ui 类 包 下 的 UiEditText， 该 类 的 完整 实现 如 代码 清单 7-81 所 示 。 另 外 ， 该 界面 使 用 的 任务 行为 
模式 (android: launchMode) 是 singleTop， 关 于 这 点 ， 我 们 可 以 参考 2.3.4 节 中 与 Task 任 务 的 相关 内 容 。 
代码 清单 7-81 
package com.app.demos.ui; 
import java.util.HashMap; 
import com.app.demos.R; 
import com.app.demos.base.BaseMessage; 
import com.app.demos.base.BaseUiAuth; 
import com.app.demos.base.C; 
import android.os.Bundle; 
import android.view.KeyEvent; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.view. inputmethod. InputMethodManager; 
import android.widget.Button; 
import android.widget.EditText; 
public class UiEditText extends BaseUiAuth { 
private EditText mEditText; 
private Button mEditSubmit; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.ui edit); 
// 显示 软 键盘 
((InputMethodManager) getSystemService (INPUT METHOD SERVICE)). 
toggleSoftInput(0, InputMethodManager.HIDE NOT ALWAYS); 
// 界面 初始 化 
mEditText = (EditText) this.findViewById(R.id.app edit text); 
mEditSubmit = (Button) this.findViewById(R.id.app edit submit); 
// 处 理 不 同 逻辑 
Bundle params = this.getIntent () .getExtras (); 
final int action = params.getInt ("action"); 
switch (action) ( 
// 修改 签名 逻辑 
Case C.action.edittext .CONFIG: 
mEditText.setText (params .getString ("value")); 
mEditSubmit.setOnClickListener (new OnClickListener() { 
GOverride 
public void onClick(View v) ( 
String input = mEditText.getText ().toString(); 
customer.setSign(input); // 更 新 本 地 用 户 对 象 
HashMap<String, String> urlParams = new HashMap<String, String>(); 
urlParams.put ("key", "sign"); 
urlParams.put ("va1", input); 
doTaskAsync (C.task.customerEdit, C.api.customerEdit, 
urlParams) ; 
} 
DE 
break; 
// Editus 
case C.action.edittext.COMMENT: 
final String blogId = params.getString ("blogId"); 
mEditSubmit.setOnClickListener (new OnClickListener() ( 
GOverride 
public void onClick(View v) { 
String input = mEditText.getText().toString(); 
HashMap<String, String» urlParams = new HashMap<String, String>(); 
urlParams.put ("blogId", blogIg); 
urlParams.put ("content", input); 
doTaskAsync (C.task.commentCreate, C.api.commentCreate, urlParams) ; 
} 
DE 
break; 
} 
} 
//////////////////////////////////////////////////////////////////////////// 
// 异步 回调 方法 (这些 方法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 
GOverride 
public void onTaskComplete (int taskId, BaseMessage message) { 
super.onTaskComplete (taskId, message); 
doFinish(); 
l 
GOverride 
public void onNetworkError (int taskId) { 
super.onNetworkError (taskId); 
} 
HB Bg P P P P CM HH TATA P P PH TAT P P P P Pg P M AAA HH HL AAT 
// 其 他 方法 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent.KEYCODE BACK && event.getRepeatCount() == 0) ( 
doFinish(); = 
} 
return super.onKeyDown (keyCode, event); 
} 
} 
上 述 代 码 中 ， 我 们 主要 关注 该 类 的 onCreate 方 法 ， 因 为 该 方法 中 包含 了 该 “通用 ”文本 编辑 界面 的 主要 逻辑 ， 根 据 代码 注释 我 们 可 以 看 出 这 里 的 逻辑 主要 包括 修改 签名 和 发 表 评论 两 方面 ， 这 里 我 们 主 


要 关注 后 者 的 逻辑 。 发 表 评 论 的 逻辑 比较 简单 ， 


图 


效果 见 


7-25 所 示 。 


户 输入 评论 内 容 点 击 保存 按钮 后 ， 就 会 创建 一 个 目标 地 址 为 C.api.commentCreate 的 异步 任务 ， 该 任务 会 访问 服务 端的 发 表 评 论 接口 ( 见 6.5.1 节 ) ， 完 成 
后 将 执行 onTaskComplete 方 法 中 的 逻辑 关闭 本 界面 。 比 如 ， 我 们 输入 “comment 3 by james”， 然 后 点 击 保存 按钮 ， 本 界 


会 关闭 并 返回 到 微 博文 章 界 


回 


， 而 这 条 评论 信息 将 出 现在 当前 界面 上 ， 显 示 


[H| 


四 


至 于 发 表 评 论 功 能 界面 对 应 的 模板 文件 是 ui_edit.xml， 该 模板 的 代码 实现 非常 简单 ， 就 是 一 个 EditText 文 本 框 控件 加 上 一 个 按钮 控件 ， 这 和 
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严格 来 讲 ， 发 表 微 博 功 能 不 能 属于 微 博文 章 界面 的 内 容 ， 


之 处 在 于 调 


的 方法 名 不 一 样 ， 在 发 表 评论 功能 中 ， 我 们 使 


代码 清单 7-82 


图 7-25 评论 结果 显示 效果 


我 们 之 所 以 把 该 功能 的 介绍 放 在 此 处 ， 原 因 是 “发 表 微 博 功能 ”的 实现 和 上 节 刚 介绍 过 的 “发 表 评 论 功能 ”的 实现 几乎 完全 相同 ， 唯 一 的 不 同 
的 是 doEditText 方 法 ， 而 此 处 我 们 则 需要 使 用 doEditBlog 方 法 。 以 下 是 doEditBlog 方 法 的 实现 逻辑 ， 如 代码 清单 7-82 所 示 。 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void doEditBlog () { 


) 


Intent intent = new Intent(); 


intent.setAction(C.intent.action.EDITBLOG) ; 


this.startActivity (intent) ; 


public void doEditBlog (Bundle data) { 


) 


Intent intent = new Intent(); 


intent.setAction (C.intent.action.EDITBLOG) ; 


intent.putExtras (data); 
this.startActivity (intent); 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


) 


我 们 同样 可 以 在 应 


代码 清单 7-83 


配置 文件 中 找 出 与 之 相关 的 Activity 界 面 控制 器 类 ， 最 后 发 现 此 类 同样 位 于 com.app.demos.uij 包 中 ， 类 名 为 UiEditBlog。 完 整 实现 如 代码 清单 7-83 所 示 。 


package com.app.demos.ui; 
java.util.HashMap; 

com.app.demos .R; 
com.app.demos.base.BaseMessage; 
com.app.demos.base.BaseUiAuth; 
com.app.demos.base.C; 
android.os.Bundle; 
android.view.KeyEvent; 
android.view.View; 
android.view.View.OnClickListener; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


android. 


android.widget.EditText; 

class UiEditBlog extends BaseUiAuth ( 
GOverride 

public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedInstanceState) ; 
setContentView(R.layout.ui write); 


// 显示 软 键盘 


View.inputmethod. InputMethodManager; 


((InputMethodManager) getSystemService (INPUT METHOD SERVICE) ) . 
toggleSoftInput (0, InputMethodManager.HIDE NOT ALWAYS); 


// BRAS AE 


findViewByld(R.id.app_write_submit) .setOnClickListener (new OnClickListener() { 


GOverride 
public void onClick(View v) ( 


EditText mWriteText = (EditText) findViewById(R.id.app write text); 
HashMap<String, String» urlParams = new HashMap<String, String»(); 
urlParams.put ("content", mWriteText.getText ().toString()); 
doTaskAsync (C.task.blogCreate, C.api.blogCreate, urlParams); 


Jj 
n; 


} 
//////////////////////////////////////////////////////////////////////////// 
// 异 步 回调 方法 (这些 方法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 


GOve 


rride 


public void onTaskComplete (int taskId, BaseMessage message) { 


} 
GOve: 


super.onTaskComplete (taskId, message); 
doFinish(); 


rride 


public void onNetworkError (int taskId) ( 


super.onNetworkError (taskId); 


} 
//////////////////////////////////////////////////////////////////////////// 


// 
@Ove 


rride 


public boolean onKeyDown(int keyCode, KeyEvent event) ( 
if (keyCode 一 KeyEvent.KEYCODE BACK && event.getRepeatCount() — 0) ( 


doFinish(); 
} 


return super.onKeyDown (keyCode, event); 


此 类 逻辑 和 之 前 介绍 的 发 表 评论 功能 的 界面 控制 器 类 UiEditText 非 常 类 似 ， 同 样 是 在 onCreate 方 法 中 处 理 了 保存 按钮 的 点 击 事件 ， 只 不 过 这 里 请 求 的 是 服务 端的 发 表 微 博 接口 ， 此 接口 的 相关 知识 请 参 


考 6.4.1 节 。 


另外 ， 发 表 微 博 的 入 口 有 两 个 ， 其 一 是 底部 的 功能 选项 栏 最 右边 选项 按钮 ， 另 外 一 个 则 是 应 用 选项 菜单 中 的 第 一 个 选项 “ 写 微 博 ”， 这 点 可 参考 7.5.2 节 中 的 内 容 。 


79.5 ”图 片 微 博 功能 实现 


前 面 我 们 介绍 了 文字 微 博 的 实现 方法 ， 但 是 如 果 需 要 发 表 
下 来 就 看 Android 客 户 端 如 何 来 实现 了 。 相 对 于 | 


1. 选 择 | 


BH 


网 


片 微 博 的 话 就 没 这 么 简单 了 ， 客 户 端 需要 和 服务 端 紧密 配合 才 可 以 完成 这 个 任务 。 我 们 在 6.6.3 节 中 已 经 把 图 片上 传 的 服务 器 接口 准备 好 ， 接 


民 务 端的 实现 来 说 ， 客 户 端 需要 开发 的 内 容 会 更 复杂 一 些 ， 下 面 我 们 把 客户 端 功 能 分 解 为 选择 图 片 、 上 传 图片 、 显 示 图 片 三 个 部 分 来 进行 详细 讲解 。 


首先 ， 我 们 想 
始 逻辑 进行 对 比 。 为 了 便于 大 家 比 对 ， 我 们 已 经 把 


代码 清单 7-84 


为 发 表 微 博 的 界面 加 入 选择 图 片 的 功能 ， 这 就 需要 对 发 表 微 博 界面 进行 一 番 修改 了 。 下 面 我 们 就 来 看 看 在 实例 源码 中 是 如 何 实现 的 ， 大 家 可 以 把 以 下 的 代码 逻辑 和 代码 清单 7-83 中 的 原 
区 别 的 部 分 挑选 出 来 ， 见 代码 清单 7-84。 


package com.app.demos.ui; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java.util.ArrayList; 

a.util.HashMap; 

a.util.List; 

apache.http.NameValuePair; 
apache.http.message.BasicNameValuePair; 
.app.demos.R; 
.app.demos.base.BaseMessage; 
.app.demos.base.BaseUiAuth; 
.app.demos.base.C; 
.app.demos.util.AppUtil; 


jaw 
jav: 


org. 
org. 


com 
com 
com 
com 
com 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
public 

// 


android.content. Intent; 
android.database.Cursor; 
android.graphics.Bitmap; 
android.net.Uri; 

android.os.Bundle; 
android.provider.MediaStore; 
android.view.KeyEvent; 
android.view.View; 
android.view.View.OnClickListener; 
android.view.inputmethod.InputMethodManager; 
android.widget.EditText; 
android.widget.ImageView; 

class UiEditBlog extends BaseUiAuth ( 
选择 图 片 的 标志 常量 


private static final int FLAG CHOOSE IMG = 1; 


{i 


选择 图 片 的 使 用 变量 


private ImageView app write img; 

private String app write img path; 

GOverride 

public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 
setContentView(R.layout.ui write); 
// 显示 软 键盘 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 添加 图 片 选择 按钮 的 逻辑 (使 用 Intent .ACTION PICK 调 用 图 库 ) 
app_write img = (ImageView) findViewById(R.id.app write img); 
app write img.setOnClickListener (new View.OnClickListener() { 
“@override 
public void onClick(View v) { 
Intent intent = new Intent (); 
intent.setAction (Intent .ACTION_PICK) ; 
intent.setType ("image/*") ; 
startActivityForResult (intent, FLAG CHOOSE IMG); 
} 


We 
// 发 表 微 博 远 辑 
findViewById (R.id.apP_write_submit) .setOnClickListener (new OnClickListener() ( 
GOverride 
public void onClick(View v) ( 
EditText mWriteText — (EditText) findViewById(R.id.app write text); 
HashMap<String, String» urlParams = new HashMap<String, String>(); 
urlParams.put ("content", mWriteText.getText ().toString()); 
if (app write img path !- null) ( 
// 如 果 有 图 片 则 上 传 文字 加 图 片 
List<NameValuePair> files = new ArrayList<NameValuePair>(); 
files.add(new BasicNameValuePair("fileO", app write img path)); 
doTaskAsync (C.task.blogCreate, C.api.blogCreate, urlParams, files); 
} else { 
// 没有 图 片 则 仅 上 传 文字 
doTaskAsync (C.task.blogCreate, C.api.blogCreate, urlParams); 


} 
n; 


} 
GOverride 
protected void onActivityResult(int requestCode, int resultCode, Intent data) ( 


if ((requestCode == FLAG CHOOSE IMG) && resultCode == RESULT OK) { 
if (data != null) ( 
Uri uri = data.getData(); 
if (uri != null) ( 


try { 

// 获得 图 片 的 浮标 位 置 

String[] filePathColumn = { MediaStore.Images.Media.DATA ); 

Cursor cursor = getContentResolver () .query (uri, 
filePathColumn, null, null, null); 

cursor.moveToFirst () ; 

String path = cursor.getString (cursor.getColumnIndex 
(MediaStore.Images.Media.DATA)); 

cursor.close(); 

// 打印 调试 

this.toast (path); 

// 创建 用 于 上 传 的 图 片 

Bitmap bm = AppUtil.createBitmap(path, 100, 100); 

if (bm == null) { 
this.toast ("can not find img"); 

} else { 
app_write_img.setImageBitmap (bm) ; 
app_write_img path = path; 


} catch (Exception e) { 
e.printStackTrace () ; 
} 


} 
} 


} 
///////////////////////////////////////////////////////////////////////////// 


// 


async task callback methods 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


观察 以 上 代码 ， 首 先 需要 注意 的 是 使 用 Intent.ACTION_PICK 调 用 图 
用 于 获取 本 地 联系 人 、 调 用 本 地 音乐 、 调 用 本 地 视频 文件 等 方面 。 这 里 我 们 把 Intent 类 型 设置 为 “image/*” ， 系 统 就 会 自动 进入 本 地 图 


取 本 地 音乐 和 视频 文件 。 


库 的 用 法 ， 实 际 上 Intent.ACTION_PICK 是 Android 系 统 中 一 个 非常 好 用 


当然 ， 创 建 好 的 图 片 会 显示 在 发 表 微 博 的 界面 中 ， 如 图 7-26 所 示 。 模 板 的 修改 比较 简单 ， 就 是 在 输入 框 下 面 加 上 一 个 ImageView， 用 于 显示 


的 系统 消息 ， 除 了 可 以 用 
库 程 序 ; 同 理 ， 如 果 设 置 为 “audio/*” a "video/*" 则 可 用 于 获 


IR] 


于 调用 


本 地 


图 库 程序 之 外 ， 还 可 以 


其 次 ， 我 们 还 需要 学 习 配 合 使 用 startActivityForResult 和 onActivityResult 来 获取 另外 的 Activity 的 返回 信息 。 这 里 我 们 使 用 startActivityForResult 打 开本 地 图 库 程序 ， 用 户 选 择 完 图 片 之 后 传 回来 的 数 
据 就 是 使 用 onActivityResult 回 调 方法 来 接收 的 ， 在 这 里 程序 获取 到 用 户 选 择 的 图 片 浮标 并 创建 一 个 图 片 对 象 用 于 上 传 。 
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2. 上 传 图 片 


想 要 让 Android 客 户 端 使 


持 文件 上 传 的 POST 方法 ， 具 体 实现 见 代码 清单 7-85。 


86, 


代码 清单 7-85 


package com.app.demos.util; 


http://www. 
import org. 
import org. 
import org. 
import org. 
http://www. 


hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
apache.http.entity.mime.FormBodyPart; 
apache.http.entity.mime.MultipartEntity; 

apache.http.entity.mime.content.FileBody; 

apache.http.entity.mime.content.StringBody; 
hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


GSuppressWarnings ("rawtypes") 

public class AppClient ( 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
// 支持 文件 上 传 的 POST 方法 


Public 


String post (HashMap urlParams, List<NameValuePair> files) throws Exception { 


String httpResult = null; 


// 


获取 POST 参数 


HttpPost httpPost = headerFilter (new HttpPost (this.apiUrl)); 
List<NameValuePair> postParams = new ArrayList<NameValuePair>(); 
Iterator it = urlParams.entrySet ().iterator(); 

while (it.hasNext()) ( 


} 
// 


Map.Entry entry = (Map.Entry) it.next(); 
postParams.add(new BasicNameValuePair (entry.getKey().toString(), entry. 
getValue().toString())); 


获取 上 传 文件 参数 


MultipartEntity mpEntity = new MultipartEntity(); 
StringBody stringBody; 

FileBody fileBody; 

File targetFile; 

String filePath; 

FormBodyPart fbp; 


// 


填充 POST 参数 值 


for (NameValuePair queryParam : postParams) { 


} 
// 


stringBody = new StringBody (queryParam.getValue(), Charset. forName ("UTF-8") ) ; 
fbp = new FormBodyPart (queryParam.getName(), stringBody) ; 
mpEntity.addPart (fbp) ; 


填充 上 传 文件 参数 值 


for (NameValuePair param : files) { 


filePath = param.getValue(); 

targetFile = new File(filePath); 

fileBody = new FileBody(targetFile, "application/octet-stream"); 
fbp = new FormBodyPart (param.getName(), fileBody); 
mpEntity.addPart (fbp) ; 


} 

httpPost.setEntity (mpEntity) ; 
Log.w("AppClient.post.file.url", this.apiUrl); 
Log.w("AppClient.post.file.data", postParams.toString()); 


// 


提交 POST 请 求 给 服务 端 


try { 


HttpResponse response = httpClient.execute (httpPost) ; 
httpResult = EntityUtils.toString(response.getEntity()); 


} catch (ConnectTimeoutException e) { 


throw new Exception (C.err.network) ; 


} catch (Exception e) { 


e.printStackTrace (); 


} finally { 


} 


httpPost.abort (); 


Log.w("AppClient.post.file.result", httpResult) ; 
return httpResult; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


HTTP 的 POST 方式 进行 上 传 ， 首 先 需要 使 用 httpmime 库 对 框架 的 网 络 通信 类 AppClient 进 行 改造 ， 让 我 们 的 网 络 通行 模块 支持 文件 上 传 功能 ;具体 来 说 ， 也 就 是 添加 一 个 支 


阅读 以 上 代码 时 ， 笔 者 建议 大 家 与 7.3.1 节 中 的 网 络 通信 类 AppClient ( 见 代码 清单 7-32) 进行 对 照 学 习 ， 主 要 关注 如 何 使 用 httpmime 库 中 的 FormBodyPart、MultipartEntity、FileBody、 
StringBody 四 个 类 组 装 出 POST 请 求 ， 最 后 交 给 HttpClient 发 送 给 服务 器 。 


当然 仅仅 这 些 还 是 不 够 的 ， 我 们 还 需要 在 全 局 UI 基 类 (参考 7.5.1 节 ) BaseUi 以 及 异步 任务 基 类 BaseTaskPool (参考 7.4.2 节 ) 中 增加 两 个 方法 作为 接 


代码 清单 7-86 


供 界面 


类 使 有 


。 代 和 码 摘录 如 下 ， 见 代码 清单 7- 


// 以 下 是 全 局 UI 基 类 的 新 增 代码 

public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 支持 上 传 文件 的 异步 任务 方法 


Public 


void doTaskAsync (int taskId, String taskUrl, HashMap<String, String> 


taskArgs, List<NameValuePair> taskFiles) ( 
showLoadBar () ; 
taskPool.addTask(taskId, taskUrl, taskArgs, taskFiles, new BaseTask() { 


] 


GOverride 
public void onComplete (String httpResult) ( 
sendMessage (BaseTask.TASK COMPLETE, this.getId(), httpResult); 
i 
GOverride 
public void onError (String error) ( 
sendMessage (BaseTask.NETWORK ERROR, this.getId(), null); 


} 
0); 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


l 
// 以 下 是 异步 任务 基 类 的 新 增 代码 
public class BaseTaskPool { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


// 支持 上 传 文件 的 异步 任务 接口 


Public 


void addTask (int taskId，String taskUrl, HashMap<String, String> taskArgs, 


List<NameValuePair> taskFiles, BaseTask baseTask, int delayTime) { 
baseTask.setId(taskId); 
try ( 


taskPool.execute (new TaskThread (context, taskUrl, taskArgs, taskFiles, 
baseTask, delayTime)); 


} catch (Exception e) ( 


} 


taskPool . shutdown () ; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 

// 异步 任务 的 线程 实现 

private class TaskThread implements Runnable ( 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
GOverride 
public void run() { 


try { 
baseTask.onStart (); 
String httpResult - null; 
// 设置 任务 延 时 
if (this.delayTime > 0) { 
Thread. sleep (this.delayTime) ; 
} 


try { 
// 远程 任务 
if (this.taskUrl != null) { 
// 初始 化 AppClient 
AppClient client = new AppClient (this.taskUrl); 
if (HttpUtil.WAP_INT == HttpUtil.getNetType (context)) { 
client .useWap () ; 
} 
// _ GET 请求 
if (taskArgs == null) { 
httpResult = client.get(); 
// POST 请 求 
) else { 


if (taskFiles != null) { 


// 这 里 调用 AppClient 中 的 支持 文件 上 传 的 POST 方 法 
httpResult = client.post (this.taskArgs, this.taskFiles) ; 
) else { 


httpResult = client.post (this.taskArgs) ; 
} 
} 


l 
// 远程 任务 处 理 
if (httpResult != null) { 


baseTask.onComplete (httpResult) ; 
// 本 地 任务 处 理 


} else í 
baseTask.onComplete () ; 


} catch (Exception e) { 
e.printStackTrace () ; 
baseTask.onError (e.getMessage ()) ; 


} catch (Exception e) { 
e.printStackTrace () ; 
} finally { 
try { 
// 任务 结 
baseTask.onStop () ; 
} catch (Exception e) { 
e.printStackTrace () ; 
} 


有 了 支持 文件 上 传 的 doTaskAsync 方 法 ， 我 们 就 可 以 在 实例 框架 的 任意 地 方 很 方便 地 实现 文件 上 传 功能 了 。 阅 读 至 此 ， 大 家 可 以 尝试 使 
的 对 应 文件 夹 中 ， 然 后 通过 微 博 列表 接口 把 图 片 地 址 返回 给 Android 客 户 端 并 在 微 博 列表 显示 出 来 ， 如 
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微 博 实例 来 上 传 图 片 了 ， 正 常情 况 下 图 


片 会 被 保存 到 服务 器 上 
图 7-27 所 示 。 
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微 博 列表 显示 上 传 图 片 


进行 详细 介绍 。 首 先是 微 博 列表 界 


性 ， 我 们 挑选 微 博 列表 界 


E 


是 微 博 详情 界 | 


m 


片 的 时 候 我 们 才 会 把 状态 变 成 可 显 


[R] 


加 上 一 个 ImageView 控 件 ， 需 要 注意 的 是 其 默认 的 显示 属性 为 隐藏 ， 只 有 在 需 


微 博 实例 应 二 要 显示 图 片 的 地 方 有 三 个 ， 一 是 微 博 列表 界面 ， 二 是 我 的 文章 界面 
， 显 示 效 果 见 图 7-27。 模 板 变动 不 大 ， 也 就 是 在 tpl_list_blog.xml 中 的 正文 下 面 
示 ，xml 代 码 如 下 所 示 : 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
<ImageView 
android: 
android: 
android: 
android: 
android: 
android: 
http: //www.hzcourse.com, 


id="@+id/tpl list blog text picture" 
layout_widt 100dip" 
layout_height="100dip" 
paddingLeft="12dip" 

focusabl: false" 
visibility-"gone"/» 


resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


门 重点 分 析 列表 程序 的 改动 ， 我 们 曾 用 整个 7.7 节 来 介绍 首页 微 博 的 列表 界 


我 们 就 需要 对 BlogList 类 进行 一 些 修改 来 满足 显示 图 片 的 功能 ， 具 体 实现 见 代 码 清和 


public 


v = inflater.i 


7-87 


IMAT Uilndexzk4 ListView 适 配器 类 BlogList 来 实现 显示 微 博 列 表 的 功能 (参考 7.7.2 


的 实现 ， 其 中 


package com.app.demos.list; 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public class BlogList extends BaseList { T 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public final class BlogListItem { ~ 
ImageView face; 
TextView content; 
TextView uptime; 
TextView comment; 


TEER 


ImageView picture; 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
GOverride 
public View getView(int p, View v, ViewGroup parent) ( 


// àn 


比 列 表 项 数据 对 象 


blogItem = null; 

效 时 填充 数据 

null) { 

flate(R.layout.tpl list blog, null); 


blogItem = new BlogListItem(); 


blogItem.face = (ImageView) v.findViewById(R.i 
content = (TextView) v.findViewById(R.id.tpl list blog text content); 
blogItem.uptime = (TextView) v.findViewById(R.id.tpl list blog text uptime); 


.tpl list blog image face); 


对 比 新 老 版 本 的 BlogList 类 ， 我 们 能 发 现 几 个 明显 的 区 别 : 1) 增加 了 微 博 图 片 控件 ， 


blogItem.comment = (TextView) v.findViewById(R.id.tpl list blog text comment); 


blogItem.picture = 

v.setTag (blogItem); 
) else ( 

blogItem = (BlogListItem) v.getTag(); 


l 
// 填充 数据 
blogItem.uptime.setText (blogList.get (p).getUptime()); 
// fill html data 
blogItem.content.setText (AppFilter.getHtml (blogList.get (p) .getContent ())) ; 
blogItem.comment.setText (AppFilter.getHtml (blogList.get (p) .getComment () ) ) ; 
// WRAP KRAH 
String faceUrl = blogList.get (p) .getFace(); 
if (faceUrl != null && faceUrl.length() > 0) { 

Bitmap faceImage = AppCache.getImage (faceUrl); 

if (faceImage != null) { 

blogItem. face. setImageBitmap (faceImage) ; 


} else { 
blogItem. face.setImageBitmap (null); 


l 
// 加 载 微 博文 章 图 片 
String picUrl = blogList.get (p).getPicture(); 
if (picUrl != null && picUrl.length() > 0) { 
Bitmap picImage = AppCache.getCachedImage (ui.getContext (), picUrl); 
if (picImage != null) { 
blogItem.picture.setImageBitmap (picImage) ; 
blogItem.picture.setVisibility (View. VISIBLE) ; 


} else { 
blogItem.picture.setImageBitmap (null); 
blogItem.picture.setVisibility (View.GONE) ; 
} 


return v; 


(ImageView) v.findViewById(R.id.tpl list blog text picture); 


片 控件 显示 的 时 候 分 为 有 | 


于 承载 微 博 图 片 ; 2) 


在 ListView 的 泻 染 方法 getView 中 加 入 微 博 图 片 获取 和 显示 的 逻辑 。 此 处 需要 注意 的 是 ， 在 


片 和 无 


片 两 种 情况 ， 有 


片 除 了 需要 设 


片 内 容 还 需要 把 加 


i] 


片 控件 属性 设 


D 
D 
D 
D 


为 可 见 ， 无 图 片 也 需要 对 图 片 控件 进行 控制 ， 这 是 为 了 防止 ListView 在 刷新 缓存 的 时 候 i 


EE 


除了 BlogList， 我 们 也 修改 了 ExpandList 的 实现 方式 ， 让 自 定义 的 微 博 列表 类 ExpandList 也 能 实现 显示 微 博 
实 这 里 的 修改 方法 和 BlogList 是 很 相近 的 。 


相对 于 列表 界面 来 说 ， 微 博文 章 界面 的 实现 就 简单 了 ， 只 需要 在 模板 文件 中 加 入 


网 


人 体 实现 大 家 可 以 参考 源码 UiBlog.java， 我 们 主要 关注 图 片 显示 的 用 法 ， 见 代码 清单 7-88。 


y 


片 的 功能 。 可 以 把 源码 中 的 ExpandList 类 与 7.8.3 节 中 的 代码 清单 7-76 进 行 比 对 学 习 ， 大 家 


片 控件 ， 然 后 代码 控制 显示 即 可 。 先 来 看 看 最 终 显示 效果 ， 如 


中 | 


7-28 所 示 。 由 于 代码 逻辑 相对 比较 简单 ， 这 里 就 不 做 


James 


tas 


图 7-28 微 博文 章 界面 


代码 清单 7-88 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
<ImageView 
android: layout_below="@+id/app_blog_text_content" 
android: id="@+id/app_ blog text picture" 
android:layout width-"fill parent" 
android:layout height-"300dp" 
android: layout_weight="1" 
android: padding="5dip" 
android: scaleType="fitStart" 
android:visibility="gone"/> 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


从 上 述 模板 代码 中 ， 我 们 注意 到 scaleType 这 个 属性 ， 在 实际 项 目 中 我 们 经 常 使 用 这 个 属性 来 调整 图 片 显示 的 方法 。 这 里 我 们 使 用 fitStart 来 控制 图 片 按 比 例 放大 或 缩小 到 上 层 View 的 宽度 ， 并 在 左上 方 
显示 。 以 下 是 该 属性 所 有 选项 的 用 法 说 明 ， 大 家 可 以 根据 实际 需求 苦 酌 使 用 。 


center: 按 图 片 的 原始 尺寸 居中 显示 ， 当 图 片 长 ( 宽 ) 超过 View 的 长 ( 宽 ) 时 ,截取 图 片 的 居中 部 分 显示 。 


- centerCrop: 按 比例 扩大 图 片 的 尺寸 并 居中 显示 ， 使 得 图 片 长 ( 宽 ) 等 于 或 大 于 View 的 长 〈 宽 ) ， 截 掉 图 片 多 出 的 部 分 。 


: centerlnside: 将 图 片 完整 居中 显示 ， 通 过 按 比 例 缩 小 图 片 尺寸 ， 使 得 图 片 长 ( 宽 ) 等 于 或 小 于 View 的 长 ( 宽 ) 。 


: fitCenter: 把 图 片 按 比例 扩大 或 缩小 到 上 层 View 的 宽度 ， 并 居中 显示 。 


“fitStart: 把 图 片 按 比 例 扩 大 或 缩小 到 上 层 View 的 宽度 ， 在 左上 方 显示 。 


: fitEnd: 把 图 片 按 比 例 扩大 或 缩小 到 View 的 宽度 ， 在 下 方 显示 。 


- fitXY: 把 图 片 拉 伸 到 View 的 大 小 显示 。 


- matrix: 用 矩阵 来 绘制 显示 部 分 。 


至 此 ， 我 们 终于 让 微 博 实例 支持 图 片上 传 和 显示 了 ， 这 大 大 增强 了 实例 应 用 的 实用 性 和 可 玩 性 。 有 兴趣 的 朋友 还 可 以 尝试 把 图 片上 传 接口 和 相机 结合 起 来 ， 让 发 表 微 博 的 方式 更 加 丰富 ， 关 于 Android 
设备 使 用 摄像 头 的 内 容 可 参考 11.4 节 。 


710 用户 配置 界面 


户 配置 界面 主 : 


户 配置 有 关 的 功能 i 


户 的 信息 总 览 ， 以 及 与 


于 显示 当前 


项 列表 ， 该 列表 包括 了 修改 签名 和 更 换 头 像 两 个 主要 功能 ， 该 界面 的 入 口 是 底 部 的 功能 ; 
按钮 。 在 本 界面 中 我 们 将 学 习 到 在 客户 端 进行 文字 编辑 的 方法 ， 以 及 一 些 特殊 布局 (比如 GridView) 的 使 用 。 


项 栏 从 左 往 右 数 的 第 三 个 选项 


小 贴 士 : 至 此 微 博 应 用 底部 的 功能 选项 栏 的 所 有 选项 按钮 都 介绍 过 了 ， 从 左 到 右 分 别 是 : 微 博 列表 界面 (7.7 节 ) 、 我 的 微 博 列表 (7.8 节 ) 、 用 户 配 置 界面 (7.10 节 ) 以 及 发 表 微 博 功 能 (7.9.4 节 ) o 


7.10.1 ”界面 程序 逻辑 


配置 界面 比较 简单 ， 主 界面 可 分 为 上 下 两 部 分 ， 上 方 是 用 户 的 信息 总 览 ， 这 里 主要 包括 
配置 界面 的 界面 控制 器 类 为 UiConfig， 完 整 实现 如 代码 清单 7-89 所 示 。 


头像 、 


代码 清单 7-89 


户 签名 、 微 博 个 数 以 及 粉丝 个 数 ; 下 方 是 功能 选项 列表 ， 包 括 修改 签名 和 更 换 头像 两 个 主要 功 


package com.app.demos.ui; 
import java.util.ArrayList; 
import java.util.HashMap; 
import com.app.demos.R; 
import com.app.demos.base.BaseHandler; 
import com.app.demos.base.BaseMessage; 
import com.app.demos.base.BaseTask; 
import com.app.demos.base.BaseUi; 
import com.app.demos.base.BaseUiAuth; 
import com.app.demos.base.C; 
import com.app.demos.list.SimpleList; 
import com.app.demos.model.Config; 
import com.app.demos.model.Customer; 
import com.app.demos.util.AppCache; 
import com.app.demos.util.AppUtil; 
import com.app.demos.util.UIUtil; 
import android.graphics.Bitmap; 
import android.os.Bundle; 
import android.os.Message; 
import android.view.KeyEvent; 
import android.view.View; 
import android.widget.AdapterView; 
import android.widget.ImageButton; 
import android.widget.ImageView; 
import android.widget.ListView; 
import android.widget.TextView; 
import android.widget.AdapterView.OnItemClickListener; 
public class UiConfig extends BaseUiAuth ( 
private ListView listConfig; 
private ImageView faceImage; 
private String faceImageUrl; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.ui config); 
// 设置 界面 消息 处 理 器 
this.setHandler (new ConfigHandler (this) ); 
// 设置 底部 选项 效果 
ImageButton ib = (ImageButton) this.findViewById(R.id.main tab 3); 
ib.setImageResource (R.drawable.tab conf 2); E 
// 获取 配置 功能 列表 
listConfig = (ListView) findViewById(R.id.app config list main); 
} 
@Override 
public void onStart() { 
super.onStart (); 
// 列表 参数 准备 


final ArrayList<Config> dataList = new ArrayList<Config>(); 


dataList.add(new Config (getResources() .getString(R.string.config_face), customer.getFace () ) 
dataList.add(new Config (getResources() .getString(R.string.config_sign), customer.getSign()) 


String[] from = (Config.COL NAME); 
int[] to = {R.id.tpl_list_menu_text_name}; 
// 使 用 SimpleList 列 表 
listConfig.setAdapter (new SimpleList (this, AppUtil.dataToList (dataList, 
from), R.layout.tpl list menu, from, to)); 
listConfig.setOnItemClickListener (new OnItemClickListener () { 

GOverride 


); 
); 


public void onItemClick (AdapterView<?> parent, View view, int pos, long id) { 


// 修改 头像 逻辑 

if (pos 一 0) { 
overlay (UiSetFace.class) ; 

// 修改 签名 逻辑 

) else ( 
Bundle data = new Bundle(); 
data.putInt ("action", C.action.edittext.CONFIG) ; 
data.putString("value", dataList.get (pos) .getValue()); 
doEditText (data); 

] 

+ 


1; 

// 获取 用 户 信息 

HashMap<String, String> cvParams = new HashMap<String, String>(); 
cvParams.put ("customerId", customer.getId()); 

this.doTaskAsync (C.task.customerView, C.api.customerView, cvParams); 


f 
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// 异 步 回调 方法 (这些 方 法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 
GOverride 
public void onTaskComplete (int taskId, BaseMessage message) { 
super.onTaskComplete (taskId, message); 
switch (taskId) ( 
case C.task.customerView: 
try ( 
final Customer customer - (Customer) message. 
getResult ("Customer"); 
TextView textTop = (TextView) this.findViewById 
(R.id.tpl list info text top); 
TextView textBottom = (TextView) this.findViewById 
(R.id.tpl list info text bottom); 
textTop.setText (customer.getSign()); 
textBottom.setText (UIUtil.getCustomerInfo 
(this, customer)); 
// 异步 加 载 头像 
faceImage = (ImageView) this.findViewById(R.id.tpl 
list_info_image face); T 
faceImageUrl = customer.getFaceurl (); 
loadImage (faceImageUrl); 
} catch (Exception e) { 
e.printStackTrace () ; 
toast (e.getMessage () ) ; 
} 
break; 
l 
} 
GOverride 
public void onNetworkError (int taskId) ( 


super.onNetworkError (taskId) ; 


} 
//////////////////////////////////////////////////////////////////////////7/7/ 


// 其 他 方法 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) ( 
if (keyCode == KeyEvent.KEYCODE BACK && event.getRepeatCount() == 0) ( 


this.forward(UiIndex.class); 


} 


return super.onKeyDown (keyCode, event); 


} 
WA GLB p OLLULLE DAR RES TL ALEE ELEAL GAEE 
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private class ConfigHandler extends BaseHandler { 
public ConfigHandler (BaseUi ui) { 
super (ui); 
l 
GOverride 
public void handleMessage (Message msg) ( 
super.handleMessage (msg) ; 
try ( 
switch (msg.what) ( 
case BaseTask.LOAD IMAGE: 
Bitmap face = AppCache.getImage (faceImageUrl); 
faceImage.setImageBitmap (face); 
break; 
} 
} catch (Exception e) { 
e.printStackTrace () ; 
ui.toast (e.getMessage () ) ; 


Ej 


控制 类 BaseUiAuth， 下 面 我 们 将 对 代码 中 比较 重要 的 方法 逻辑 进行 剖析 和 归纳 。 


UiConfig 同 样 继承 自 登录 界 


1.onCreate 方 法 


界面 初始 化 方法 的 逻辑 比较 简单 ， 首 先 设置 界面 消息 处 理 器 ， 然 后 设置 底部 的 选项 显示 效果 ， 最 后 获取 功能 选项 列表 的 ListView 控 件 。 


2.onStart75; 


要 包括 两 方面 逻辑 。 其 一 ， 显 示 功 能 选项 列表 ， 这 里 使 用 了 自 定 义 的 选项 列表 SimpleList 适 配器 来 实现 ， 具 体内 容 请 参考 7.10.2 节 ; 其 二 ， 获 取 用 户 相关 信息 ， 该 逻辑 使 用 异步 任务 方法 doTaskAsync 
来 实现 ， 请 求 的 是 服务 端的 查看 用 户 信息 接口 ， 该 逻辑 前 面 已 经 介绍 的 非常 多 了 ， 这 里 不 再 乾 述 。 


3.onTaskComplete 方 法 


此 方法 用 于 把 获取 到 的 用 户 信息 显示 在 用 户 配置 界面 上 ， 还 使 用 oadlmage 方 法 异步 加 载 用 户头 像 。 类 似 逻 辑 之 前 也 已 经 介绍 多 次 ， 如 我 的 微 博 列表 界面 里 的 BlogsHandler 以 及 微 博 文章 界面 中 的 


BlogHandler 等 ， 这 里 就 不 做 介绍 了 。 


回 


至 此 ， 我 的 微 博 列表 界面 的 程序 逻辑 已 经 介绍 完毕 。 以 下 是 我 的 微 博 列表 界面 的 模板 文件 是 ui_config.xml， 如 代码 清单 7-90 所 示 。 


代码 清单 7-90 


<?xml version="1.0" encoding="utf-8"?> 
<merge xmlns:android="http://schemas.android.com/apk/res/android"> 
<include layout="@layout/main layout" /> 
<LinearLayout E 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"? 
«include layout="@layout/main_top" /> 
<ScrollView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:scrollbars-"vertical" 
android:layout weight-"1" 
android:fillViewport-"true"» 
<LinearLayout 
android: layout_width="fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«include layout-"(layout/tpl list info" /> 
«ListView n = 
android: id="@+id/app_ config list main" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout marginLeft-"l0dip" 
android:layout marginRight-"10dip" 
android:background-"Gdrawable/xml list config bg" 
android:descendantFocusability-"blocksDescendants" 
android:divider-"8color/dividerl" 
android:dividerHeight="1dip" 
android: listSelector="@drawable/xml_list_bg"/> 
</LinearLayout> T 2 
</ScrollView> 
<include layout="@layout/main_tab" /> 
</LinearLayout> T 
</merge> 


户 配 置 界面 的 显示 效果 如 图 7-29 所 示 。 
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图 7-29 用户 配置 界面 运行 效果 


7.10.2 ”使 用 自 定义 选项 列表 


在 7.8.3 节 中 ， 我 们 曾经 介绍 过 自 定义 微 博 列 表 ExpandList 的 用 法 ， 这 里 我 们 来 介绍 另外 一 个 自 定义 的 列表 适配器 类 ， 也 就 是 用 户 配 置 界 面 中 的 SimpleList 的 用 法 。SimpleList 的 实现 和 ExpandList 大 不 
相同 ， 由 于 继承 自 简单 适配器 类 SimpleAdapter (参考 7.7.2 节 ) ， 因 此 用 法 更 类 似 于 SimpleAdapter。 我 们 先 来 看 看 该 类 的 完整 实现 ， 如 代码 清单 7-91 所 示 。 


代码 清单 7-91 


package com.app.demos.list; 
import java.util.List; 
import java.util.Map; 
import com.app.demos.util.AppFilter; 
import android.content.Context; 
import android.widget.SimpleAdapter; 
import android.widget.TextView; 
public class SimpleList extends SimpleAdapter { 
public SimpleList(Context context, List«? extends Map<String, ?>> data, 
int resource, String[] from, int[] to) ( 
super(context, data, resource, from, to); 
} 
GOverride 
public void setViewText (TextView v, String text) { 
AppFilter.setHtml(v, text); 
} 


通过 代码 我 们 可 以 看 出 SimpleList 实 际 上 是 对 SimpleAdapter 适 配器 类 的 简单 封装 ， 因 此 在 用 户 配置 界面 控制 器 类 UiConfig 里 的 用 法 ( 见 代码 清单 7-89) 也 可 以 被 当做 是 SimpleAdapter 的 使 用 范 
例 ，SimpleAdapter 类 我 们 在 7.7.2 节 中 已 经 详细 介绍 过 ， 这 里 就 不 做 介绍 了 。 


7.10.3 ”修改 签名 功能 实现 


从 用 户 配 置 界面 控制 器 类 UiConfig 的 代码 中 可 以 看 出 ， 当 我 们 点 击 功能 列表 中 的 修改 签名 选项 时 ， 将 触发 点 击 事件 中 的 doEditText 方 法 来 打开 微 博 应 用 中 的 “通用 ”文本 编辑 界面 ， 该 界面 效果 如 图 7- 
24 所 示 ， 罗 辑 代码 可 参考 7.9.3 节 中 介绍 过 的 UiEditText 界 面 控制 器 类 的 内 容 。 实 际 上 ， 修 改 签名 功能 的 实现 方式 和 之 前 介绍 的 发 表 评 论 功能 的 实现 方式 非常 相似 。 之 前 我 们 介绍 UiEditText 类 代码 逻辑 的 时 
候 ， 曾 经 分 析 过 在 该 界面 中 发 表 评论 的 功能 逻辑 ， 这 里 我 们 将 要 介绍 该 类 的 另 一 个 重要 逻辑 ， 也 就 是 修改 签名 功能 的 实现 。 


参考 代码 清单 7-81 中 UiEditText 类 的 代码 ，onCreate 方 法 中 C.action.edittext.CONFIG 段 的 逻辑 。 当 修改 签名 的 文本 编辑 界面 中 的 “保存 ”按钮 被 按 下 时 ， 首 先 会 执行 本 地 用 户 对 象 的 setSign 方 法 来 
更 新 签名 数据 ， 保 证 本 地 用 户 对 象 信息 的 及 时 更 新 ;然后 再 把 签名 数据 传 至 更 新 用 户 信息 接口 ( 见 6.3.2 节 ) 中 去 ， 保 证 服务 端 数据 与 客户 端 同步 。 当 我 们 回 到 用 户 配置 界面 的 时 候 ， 就 可 以 通过 任何 一 种 方 
式 来 获取 修改 过 的 签名 信息 了 。 


小 贴 士 : 本 地 用 户 (Customer) 对 和 象 是 BaseUiAuth 类 中 设置 的 用 户 对 象 ， 是 登录 之 后 保存 在 应 用 内 存 里 的 ， 理 论 上 可 以 在 BaseUiAuth 的 任何 子 类 内 使 用 ， 避 免 频 繁 访问 查看 用 户 信息 接 口 带 来 的 性 能 问 


这 里 我 们 可 以 看 到 ， 不 管 是 发 表 评论 功能 还 是 修改 签名 功能 ， 都 使 用 doEditText 方 法 来 打开 微 博 应 用 的 “通用 ”文本 编辑 界面 来 供用 户 编辑 ， 再 根据 获取 到 的 action 参 数值 在 UiEditText 类 中 分 别处 
理 不 同 的 文本 保存 逻辑 。 实 际 上 ， 这 也 是 一 种 界面 复 用 的 方法 。 在 Android 应 用 开发 中 ,我 们 可 以 把 一 些 外 观 相同 的 界面 合并 起 来 ， 通 过 不 同 的 参数 值 来 完成 多 种 功能 ,这 种 方式 可 以 让 应 用 的 结构 更 合 
理 、 重 用 性 更 强 。 


7.10.4. 更换 头像 功能 实现 


在 用 户 配置 界面 点 击 “ 更 换 头 像 ” 选 项 时 就 会 进入 更 换 头 像 界面 ， 该 界面 会 显示 微 博 应 用 中 可 供用 户 选 择 的 头像 
们 采用 GridView 控 件 来 实现 。 


网 
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面 效 果 如 图 7-30 所 示 。 我 们 可 以 看 到 该 界面 采用 的 是 网 格 形式 的 布局 ， 因 此 我 
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系 。 
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7-30 ”更 换 头像 界面 运行 效果 


GridView 即 网 格 列表 控件 ， 常 用 于 展示 按照 网 格 形式 排 布 的 界面 ， 其 实 GridView 也 属于 列表 控件 中 的 一 种 。GridView 类 位 于 android.widget 包 下 ， 继 承 自 ViewGroup， 下 面 是 GridView 类 的 继承 关 


java.lang.Object 
|- android.view.View 
|- android.view.ViewGroup 
|- android.widget.AdapterView 
|- android.widget.AbsListView 
|- android.widget.GridView 


GridView 和 ListView 同 样 继承 了 View 和 ViewGroup 的 所 有 属性 ， 我 们 把 GridView 控 件 特 有 属性 的 使 


表 7-10 GridView? 


方法 以 及 属性 对 应 的 操作 方法 总 结 在 表 7-10 中 。 


件 常用 属性 


属性 名 操作 方法 


android:column Width setColumnWidth(int) 
android:gravity setGravity(int) 
android:horizontalSpacing setHorizontalSpacing(int) 
android:numColumns setNumColumns(int) 
android:stretchMode setStretchMode(int) 
android:verticalSpacing setVerticalSpacing(int) 


使 用 说 明 


网 格 项 的 宽度 

网 格 项 的 gravity fH 

网 格 项 水 平 间 距 

网 格 列 数 ， 即 横 排 的 网 格 项 数 

缩放 模式 ， 一 般 采用 columnWidth 宽度 自 适 应 
网 格 项 垂直 间距 


下 面 我 们 来 分 析 更 换 头像 界面 的 模板 代码 ， 即 ui_face.xm lI 文件 的 内 容 ， 如 代码 清单 7-92 所 示 。 该 界 


H 


代码 清单 7-92 


的 布 


局 比较 简单 ， 就 是 线性 布局 内 部 谋 套 着 个 GridView 网 格 列 表 ， 该 GridView 网 格 布局 共有 3 列 ， 


an 
Y 


宽度 自 适应 模式 ， 网 格 项 居中 显示 ， 宽 度 为 100dip， 横 竖 间 距 均 为 10dip， 最 终 显示 效果 可 参考 图 7-30 所 示 。 


<?xml version="1.0" encoding="utf-8"?> 
«merge xmlns:android="http://schemas.android.com/apk/res/android"> 
<include layout="@layout/main_ layout" /> 
<LinearLayout m 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android: layout_height="wrap_content"> 
<GridView 
android: id="@+id/app_face_grid" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:numColumns="3" 
android: gravity="center" 
android: columnWidth="100dip" 
android: verticalSpacing="10dip" 
android: horizontalSpacing="10dip" 
android: stretchMode="columnWidth" 
android: layout_weight="1"/> 
</LinearLayout> 
</merge> 


更 换 头 像 界 面 对 应 的 界面 控制 器 类 文件 是 com.app.demos.ui 类 包 下 的 UisetFacejava， 实 现 逻 辑 如 代码 清单 7-93 所 示 ， 下 面 我 们 来 分 析 UiSetFace 类 中 的 重点 逻辑 。 


代码 清单 7-93 


package com.app.demos.ui; 
import java.util.ArrayList; 
import java.util.HashMap; 
import com.app.demos.R; 
import com.app.demos.base.BaseMessage; 
import com.app.demos.base.BaseUiAuth; 
import com.app.demos.base.C; 
import com.app.demos.list.GridImageList; 
import com.app.demos.model.Image; 
import android.os.Bundle; 
import android.view.KeyEvent; 
import android.view.View; 
import android.widget.AdapterView; 
import android.widget.AdapterView.OnItemClickListener; 
import android.widget.GridView; 
public class UiSetFace extends BaseUiAuth { 
GridView faceGridView - null; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.ui face); 
// 获取 头像 列表 数据 
this.doTaskAsync(C.task.faceList, C.api.faceList); 


l 
// 设置 头像 方法 
private void doSetFace (String faceId) { 
HashMap<String, String> urlParams = new HashMap<String, String>(); 
urlParams.put("key", "face"); 
urlParams.put("val", faceIq); 
doTaskAsync(C.task.customerEdit, C.api.customerEdit, urlParams); 


} 
//////////////////////////////////////////////////////////////////////////// 
// 异 步 回调 方法 〈 这 些 方法 在 获取 到 网 络 请 求 之 后 才 会 被 调用 ) 
GOverride 
public void onTaskComplete (int taskId, BaseMessage message) { 
super.onTaskComplete (taskId, message); 
switch (taskId) { 
// BRERA RE 
case C.task.faceList: 
try { 
GSuppressWarnings ("unchecked") 


final ArrayList<Image> imageList = (ArrayList<Image>) message. 


getResultList ("Image") ; 

final ArrayList<String> imageUrls = 
for (int i = 0; i < imageList.size(); i++) { 
Image imageItem = imageList.get (i); 
imageUrls.add (imageItem.getUrl()); 


} 
faceGridView = (GridView) this.findViewById(R.id.app_ 
face grid); 
faceGridView.setAdapter (new GridImageList (this, imageUrls)); 
faceGridView.setOnItemClickListener 
(new OnItemClickListener () { 
GOverride 


new ArrayList<String>(); 


public void onItemClick (AdapterView<?> parent, View view, 


int position, long id) { 
Image face = imageList.get (position) ; 
customer.setFace (face.getId()); 
doSetFace (face.getId()); 
} 
n; 
} catch (Exception e) { 
e.printStackTrace(); 
toast (e.getMessage () ) ; 
} 
break; 
// 设置 头像 逻辑 
case C.task.customerEdit: 
toast ("face has changed."); 
doFinish(); 
break; 
l 
} 
GOverride 
public void onNetworkError (int taskId) ( 
super.onNetworkError (taskId); 


} 
//////////////////////////////////////////////////////////////////////////// 


// 其 他 方法 
GOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode 一 KeyEvent.KEYCODE BACK && event.getRepeatCount() — 0) ( 


this.finish(); 
} 


return super.onKeyDown (keyCode, event); 


上 述 程序 中 ， 首 先 会 创建 一 个 ID 为 C.task.faceList 的 异步 任务 ， 用 于 从 服务 端的 头像 列表 接口 ( 见 6.6.2 节 ) 获取 最 新 可 供 选 择 的 头像 列表 信息 ， 成 功 后 在 onTaskComplete 对 应 的 逻辑 中 进行 处 理 。 处 
理 逻 辑 并 不 复杂 ， 首 先 ， 程 序 会 将 获取 到 的 头像 图 片 列表 信息 保存 到 Image 模 型 列表 ， 即 imageList 变 量 中 ; 然后 ， 抽 取 其 中 的 图 片 URL 地 址 信息 并 存放 到 imageUrls 列 表 中 ; 最 后 ， 使 用 列表 适配器 类 
GridlmageList 来 显示 网 格 头像 列表 。 前 面 我 们 已 经 介绍 过 很 多 列表 适配器 ， 包 括 微 博 列表 界面 中 的 BlogList、 我 的 微 博 列表 界面 中 的 ExpandList 以 及 用 户 配 置 界面 中 的 SimpleList 等 ， 接 下 来 我 们 将 再 给 大 
家 介绍 一 种 常见 列表 适配器 的 使 用 ， 也 就 是 这 里 的 网 格 列表 适配器 GridlmageList， 该 类 的 实现 逻辑 如 代码 清单 7-94 所 示 。 


=l 


代码 清单 7-94 


package com.app.demos.list; 
import java.util.List; 
import com.app.demos.util.AppCache; 
import android.content.Context; 
import android.graphics.Bitmap; 
import android.view.View; 
import android.view.ViewGroup; 
import android.widget.BaseAdapter; 
import android.widget.GridView; 
import android.widget.ImageView; 
public class GridImagelist extends BaseAdapter ( 
private Context context; 
private List«String» imageUrls; 
public GridImageList (Context context, List<String> imageUrls) ( 
this.context = context; 
this.imageUrls = imageUrls; 
} 
GOverride 
public int getCount() ( 
return imageUrls.size(); 
l 
GOverride 
public Object getItem(int position) { 
return position; 
} 
GOverride 
public long getItemId(int position) { 
return position; 
] 
GOverride 
public View getView(int position, View convertView, ViewGroup parent) ( 
// 设置 图 片 控件 元 素 的 样式 
ImageView imageView = new ImageView (context) ; 
imageView.setLayoutParams (new GridView.LayoutParams (100, 100)); 
imageView.setScaleType (ImageView.ScaleType.FIT CENTER) ; 
imageView.setPadding(10, 10, 10, 10); T 
// 从 缓存 中 或 者 远程 获取 图 片 
Bitmap bitmap = AppCache.getCachedImage (context, imageUrls.get (position)); 
imageView.setImageBitmap (bitmap); 
return imageView; 


[D 


我 们 重点 关注 该 类 的 getView 方 法 ， 先 设置 网 格 列表 项 中 图 片 控件 的 样式 ， 然 后 根据 该 图 片 的 URL 值 从 缓存 中 或 者 远程 获取 实际 图 片 。 至 于 异步 获取 
代码 清单 7-67 相 关 的 内 容 。 最 后 我 们 把 GridlmageList 适 配器 类 的 对 象 实例 通 过 setAdapter 方 法 设置 到 头像 列表 控件 的 GridView 对 象 中 即 可 。 


网 
网 


片 的 getCachedlmage 方 法 ， 可 参考 7.7.5 节 中 与 


[D 


回 到 更 换 头 像 界面 控制 器 类 UiSetFace 的 逻辑 中 ， 当 程序 完成 对 头像 网 格 列 表 控 件 对 象 GridView 的 列表 适配器 设置 之 后 ， 还 需要 使 用 setOnltemClickListener 方 法 设置 点 击 每 个 网 格 列表 项 ( 即 用 户头 
像 ) 所 要 触发 的 点 击 事件 ， 即 doSetFace 的 方法 逻辑 ， 创 建 一 个 ID 为 C.task.customerEdit 的 异步 任务 ， 用 于 请 求 服务 端的 更 新 用 户 信息 接口 ( 见 6.3.2 节 ) 来 更 新 用 户 的 头像 设置 。 假 如 我 们 选择 第 二 排 的 第 
一 个 笑脸 头像 ， 逻 辑 执行 成 功 后 就 会 提示 “face has changed” 信 息 并 关闭 当前 界面 。 当 返回 用 户 配 置 界 面 的 时 候 ， 我 们 会 发 现 头像 已 经 被 更 新 了 ， 效 果 如 图 7-31 所 示 。 
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face has changed. | 


图 7-31 更 换 头像 结果 显示 


711 ”网 页 界面 开发 


前 面 我 们 已 经 把 微 博 应 用 客户 端 部 分 的 主要 内 容 大 致 介绍 完了 ， 不 仅 包 括 登 录 界 面 、 微 博 列表 界面 、 我 的 微 博 列表 界面 、 微 博文 章 界面 以 及 用 户 配置 界面 等 
面 、 发 送 微 博 界面 以 及 更 换 头 像 界 面 等 功能 界面 的 实现 。 以 上 这 些 界面 都 基于 Android Ul 系 统 来 构建 的 ， 然 而 本 节 将 介绍 的 是 另外 一 种 Android 应 用 的 构建 思路 ， 


之 路 。 


使 用 网 页 来 作为 Android 应 用 的 界面 ， 实 际 上 就 是 使 用 制作 网 站 的 思路 来 设计 和 制作 Android 应 用 ， 这 种 内 嵌 网 页 的 做 法 可 以 很 大 程度 上 简化 Android 应 用 的 


FSZZT 


发 , 因 


面 的 逻辑 ， 也 包括 通用 文本 编辑 界 
也 就 是 基于 网 页 (Web) 的 Android 开 发 


为 HTML 语 言 的 学 习 成 本 要 比 


Android 应 用 框架 小 多 了 。 并 且 ， 使 用 这 种 方式 有 很 多 优点 ， 比 如 可 以 加 快 开发 进度 ， 减 少 设备 兼容 性 导致 的 问题 ， 还 可 以 随时 调整 界面 ， 避 免 了 由 于 界面 修改 而 需要 频繁 更 新 客户 端 。 不 过 ， 这 种 做 法 也 
有 局 限 性 ， 因 为 每 次 从 服务 端 获取 网 页 内 容 非常 耗费 网 络 资源 ， 如 果 设 备 未 联网 的 话 就 完全 无 法 使 用 了 ; 另外 ， 网 页 的 显示 效果 和 泻 染 速度 比 原生 的 Android Ul 要 差 上 许多 。 


7.11.1 ”界面 程序 逻辑 


由 于 内 嵌 网 页 界面 实例 和 微 博 应 用 实例 没有 太 大 的 关系 ， 所 以 有 关 的 界面 控制 器 类 被 放 到 了 com.app.demos.demo 类 包 目 录 下 ， 包 含有 “基本 用 法 实例 界 


(DemoMap) ”两 个 界面 控制 器 类 ， 前 者 包含 了 内 谱 网 页 常见 用 法 功能 点 的 综合 实例 ， 而 后 者 则 可 作为 互联 网 应 用 的 代表 实例 。 至 于 这 两 个 界面 的 具体 代码 和 


的 各 个 小 节 中 给 大 家 作 详 细 介 绍 。 


另外 ， 需 要 嵌入 到 界面 中 的 网 页 版 接口 的 相关 内 容 我 们 已 经 在 6.8 节 中 介绍 过 了 ， 比 如 我 们 在 浏览 器 中 输入 网 页 版 接口 的 站 点 入 口 地 址 ， 即 http://127.0.0.1: 8002/index.php， 就 可 以 看 到 “基本 用 法 


面 (DemoWeb) ”和 “网 页 地 图 实例 界面 
0 实现 逻辑 ， 我 们 将 按照 功能 点 来 分 别 在 后 五 


实例 界面 ”的 入 口 页 面 ， 如 图 6-4 所 示 。 该 页 面 是 所 有 内 嵌 网 页 实例 界面 的 入 口 ， 包 含 了 内 谋 网 页 常见 用 法 的 大 部 分 功能 点 ， 下 节 中 我 们 将 以 此 界面 的 控制 器 类 DemoWeb 为 例 ， 给 大 家 介绍 网 页 界面 的 开 


发 。 


7.11.2 使 用 WebView 


Android 应 用 框架 中 进行 内 赃 网 页 界面 的 开发 需要 使 用 WebView 控 件 ， 该 控件 建立 在 强大 的 Webkit 内 核 之 上 ， 可 作为 应 用 的 内 嵌 浏 览 器 使 用 。 另 外 ， 该 控件 还 具 


中 嵌入 该 控件 ， 比 如 在 基本 用 法 实例 界面 的 模板 demo_web.xml 中 ，WebView 的 用 法 如 代码 清单 7-95 所 示 。 
小 贴 士 :我们 可 以 通过 WebSettings 类 中 的 setBuiltInZoomControls (boolean) 方法 来 设置 WebView 组 件 的 导航 栏 。 


代码 清单 7-95 


备 了 常用 浏览 器 绝 大 部 分 的 功能 ， 包 
括 前 进 、 后 台 、 缩 小 和 放大 等 导航 栏 功 能 。WebView 类 位 于 android.webkit 包 下 ， 继 承 自 绝对 布局 (AbsoluteLayout) ， 也 正 因此 ，WebView 的 属性 和 大 部 分 的 布局 控件 都 差不多 。 我 们 可 以 在 界面 模板 


<?xml version-"1.0" encoding="utf-8"?> 
«merge xmlns:android="http: //schemas.android.com/apk/res/android"> 
<include layout="@layout/main_ layout" /> 
<LinearLayout = 
android: orientation="vertical" 
android: layout width-"fill parent" 
android:layout height-"fill parent"» 
«include layout-"G(layout/main top" /> 
<WebView p 
android:id="@+id/web_form" 
android:layout_height="fill_parent" 
android:layout_width="fill_parent" 
android:layout weight="1" 7> 
<include layout="@layout/main tab" /> 
</LinearLayout> T 
</merge> 
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H 


的 主要 内 容 。 


以 上 界面 的 逻辑 代码 位 于 com.app.demos.demo 类 包 下 的 DemoWebjava 文 件 中 ， 代 码 清单 7-96 中 就 是 该 界面 控制 器 类 的 完整 实现 。 


代码 清单 7-96 


package com.app.demos.demo; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public class DemoWeb extends BaseUiWeb { m 
private WebView mWebView; 
GOverride 
public void onStart() ( 
super.onStart (); 
// 初始 化 WebView 控 件 对 象 
setContentView(R.layout.demo web); 
mWebView = (WebView) findViewById(R.id.web form); 
mWebView.getSettings () .setJavaScriptEnabled (true); 
mWebView. loadUrl (C.web. index); 
// 添加 Javascript 回 调 接口 
mWebView.addJavascriptInterface (new DemoJs () "demo"); 
// 设置 并 显示 WebView 
this.setWebView (mWebView) ; 
this.startWebView (); 
} 
protected class DemoJs { 
public void testCallBack (String testParam) { 
Log.w("DemoJs", testParam) ; 


} 


最 终 显示 效果 如 


7-32 所 示 。 
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图 7-32 ”内 识 网 页 界面 运行 效果 


我 们 可 以 看 到 ，DemoWeb 类 的 逻辑 实现 比较 简单 ， 主 要 逻辑 都 在 onStart 方 法 中 ， 先 初始 化 WebView 对 象 ， 然 后 进行 一 系列 的 功能 配置 ， 并 使 用 loadUrI 方 法 设置 需要 加 载 显示 的 网 页 地 址 ， 即 
C.web.index 常 量 值 ， 也 就 是 网 页 版 接口 的 站 点 入 口 地 址 ， 最 后 再 调用 startWebView 方 法 即 可 。 最 重要 的 逻辑 都 在 startWebView 方 法 中 ， 该 方法 的 实现 逻辑 都 在 网 页 界面 基 类 BaseUiWeb 中 (参考 代码 清 
单 7-98) ， 此 类 是 所 有 内 嵌 网 页 界面 的 控制 器 基 类 ， 其 中 包含 了 许多 知识 点 ， 我 们 将 在 7.11.3 节 和 7.11.4 节 中 做 有 针对 性 的 分 析 。 


7.11.3 ”使 用 ProgressDialog 


通过 之 前 内 容 的 介绍 ， 我 们 了 解 到 在 微 博 应 用 框架 中 ， 如 何 使 用 BaseUiWeb 中 的 方法 ， 在 内 谋 网 页 的 界面 控制 器 类 中 ， 快 速 地 使 用 WebView 控 件 加 载 并 显示 所 需 的 网 页 界面 。 然 而 ， 网 页 界面 的 初始 
化 方式 和 原生 Android Ul 界 面 不 同 ， 由 于 网 页 内 容 需 要 从 网 络 下 载 ， 界 面 加 载 的 时 间 会 比较 长 ， 因 此 我 们 为 所 有 的 网 页 界面 准备 了 进度 条 对 话 框 (ProgressDialog) 来 显示 网 页 的 加 载 进 度 ， 界 面 显 示 效果 
如 图 7-33 所 示 。 


图 7-33 ”进度 条 对 话 框 运行 结果 


的 上 下 文 对 象 即 可 创建 新 的 ProgressDialog 对 象 ， 然 后 就 可 以 


ProgressDialog 进 度 条 对 话 框 控 件 属 于 Dialog 对 话 框 控件 (参考 7.5.3 节 ) 中 的 一 种 ， 该 控件 的 用 法 比较 简单 ， 在 构造 方法 中 传 入 当前 界 
该 对 象 的 set 系 列 方 法 来 设置 该 进度 条 对 话 框 控 件 的 标题 信息 和 外 观 样式 等 ， 使 用 示例 如 代码 清单 7-97 所 示 。 


使 


代码 清单 7-97 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
ProgressDialog mProgressDialog; B 
mProgressDialog = new ProgressDialog (this); 
mProgressDialog.setProgressStyle (ProgressDialog.STYLE SPINNER); // 设置 进度 条 样式 
mProgressDialog.setTitle ("进度 条 标题 "); // 设置 进度 条 标题 
mProgressDialog.setMessage ("进度 条 信息 "); // 设置 进度 条 信息 
mProgressDialog.setCancelable (true); // 设置 是 否 包含 退回 键 
mProgressDialog.setButton (" 确 定 "，new DialogInterface.OnClickListener () { 

@Override 

public void onClick (DialogInterface dialog, int which) { 

dialog.cancel (); 

} 
DE 
mProgressDialog.show(); 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


另外 ， 在 Activity 界 面 控制 器 类 中 使 用 ProgressDialog 时 ， 我 们 还 可 以 使 
网 页 界面 的 控制 器 基 类 BaseUiWeb 中 ， 有 关 逻 辑 如 代码 清单 7-98 所 示 。 


代码 清单 7-98 


onCreateDialog 方 法 初始 化 进度 条 对 话 框 控 件 ， 这 里 所 有 的 内 族 网 页 界面 都 是 使 


这 种 方法 来 实现 的 ， 具 体 实 现代 码 在 内 让 


abstract public class BaseUiWeb extends BaseUi { 
private static final int MAX PROGRESS = 100; 
private static final int DIALOG PROGRESS = 1; 
private WebView webView; 
private int mProgress - 0; 
private ProgressDialog mProgressDialog; 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 
public void setWebView (WebView webView) ( a 
this.webView = webView; 
} 
public void startWebView() { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 设置 WebChromeClient 回 调 接口 = 
webView.setWebChromeClient (new WebChromeClient () { 
GOverride 
public void onProgressChanged (WebView view, int progress) { 
mProgress = progress; 
mProgressDialog.setProgress (mProgress) ; 
if (mProgress >= MAX PROGRESS) { 
mProgressDialog.dismiss 0; 
} 
} 


n; 
} 
@Override 
public void onStart() { 

super.onStart (); 

// 显示 进度 条 对 话 框 

showDialog (DIALOG PROGRESS); 

getWindow(). requestFeature (Window.FEATURE PROGRESS); 
} 
@Override 
protected Dialog onCreateDialog(int id) { 

switch (id) { 

case DIALOG PROGRESS: 
mProgressDialog = new ProgressDialog (this); 


http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


mProgressDialog.setTitle ("Loading http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/..."); 


mProgressDialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL); 
mProgressDialog.setMax(MAX PROGRESS); 
return mProgressDialog; 


return null; 

$ 

GOverride 

protected void onPause() ( 
webView.stopLoading () ; 
super .onPause () ; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


上 述 代码 是 ProgressDialog 在 内 嵌 网 页 界面 控制 器 类 中 的 使 
showDialog 方 法 来 调 


使 


onCreateDialog 方 法 中 与 传 入 ID 对 应 的 ProgressDialog 初 始 化 逻辑 ， 这 里 使 


逻辑 。 首 先 ， 每 个 界面 都 会 有 一 个 ID 为 DIALOG_PROGRESs 的 ProgressDialog 控 件 。 当 界面 开始 运行 的 时 候 ， 在 onStart 方 法 中 ， 程 序 会 
的 是 水 平 样式 的 进度 条 。 然 后 在 startWebView 方 法 的 WebView 加 载 逻 辑 中 加 入 该 进度 条 对 话 框 


到 了 WebView 控 件 的 WebChromeClient 


回 


控件 的 控制 。 这 里 


调 接 


中 的 onProgressChanged 方 法 来 控制 进度 条 的 显示 ， 当 进度 值 大 于 MAX_PROGRESS 时 就 隐藏 ProgressDialog 控 件 。 


除了 WebChromeClient 之 外 ，Android 应 


框架 还 为 我 们 提供 了 WebViewClient， 这 两 个 


可 调 接口 通常 被 我 们 用 来 深度 定制 个 性 化 的 WebView 控 件 。 当 然 ， 两 个 回调 接口 之 间 还 是 有 一 定 区 别 


的 ，WebViewClient 主 要 帮助 WebView 处 理 网 页 加 载 过 程 的 逻辑 ， 比 如 网 页 加 载 开始 、 加 载 结束 以 及 加 载 出 错 等 过 程 ， 该 类 的 主要 接口 方法 如 表 7-11 所 示 。 


表 7-11 WebViewClient 主 要 回调 方法 


回调 方法 


onLoadResource(WebView view. String url) 
onPageFinished(WebView view. String url) 
onPageStarted(WebView view. String url. Bitmap favicon) 


onReceivedError(WebView view. int errorCode. String 


description, String failingUrl) 


shouldOverrideKeyEvent(WebView view, KeyEvent event) 
shouldOverrideUrlLoading(WebView view. String url) 


方法 使 用 

网 页 资源 加 载 时 的 回调 方法 

网 页 加 载 结束 时 的 回调 方法 

网 页 加 载 开 始 时 的 回调 方法 

网 页 加 载 出 错时 的 回调 方法 ,包括 错误 
码 、 错 误 信 息 和 出 错 页 面 的 URL 地 址 

网 页 界面 键盘 响应 的 重 写 方法 

网 页 URL 地 址 修改 的 回调 方法 


与 WebViewClient 不 同 ，WebChromeClient 则 主 : 
千 ， 该 类 的 主要 接口 方法 如 表 7-12 所 示 。 


块 ) 


于 帮助 WebView 处 理 与 浏览 器 功能 有 关 的 逻辑 ， 比 如 创建 和 关闭 WebView 窗 口 


、 获 取 网 页 加 载 进度 以 及 重 写 部 分 浏览 器 模块 (如 Javascript 模 


表 7-12 WebChromeClient 主 要 回调 方法 


回调 方法 方法 使 用 
关闭 WebView 窗口 时 的 回调 方法 
创建 WebView 窗口 时 的 回调 方法 


onCloseWindow(WebView window) 

onCreateWindow(WebView view. boolean dialog. boolean 
userGesture, Message resultMsg) 

onJsAlert(WebView view, String url. String message. 


FA 385 V at JavaScript 的 alert 对 话 框 控件 


JsResult result) 


(E) 


回调 方法 方法 使 用 
用 于 重 写 浏览 器 JavaScript 的 confirm 对 话 框 控件 


onJsConfirm(WebView view. String url. String message. 
JsResult result) 

onProgressChanged(WebView view. int newProgress) 

onReceivedTitle(WebView view, String title) 


onRequestFocus(WebView view) 


获取 网 页 加 载 进度 的 回调 方法 
通知 主 应 用 网 页 Title 已 加 载 
显示 并 聚焦 当前 WebView 


是 可 以 同时 使 用 的 ， 在 BaseUiWeb 类 的 startWebView 方 法 中 ， 我 们 就 同时 使 用 以 上 两 个 回调 接口 来 设 定 所 需 的 WebView 控 件 ， 此 方法 可 在 


当然 ，WebViewClient 和 WebChromeClient 回 调 接 口 
BaseUiWeb 的 子 类 中 直接 使 用 。 


7.114 ”使 用 WebView 的 重 写 和 回调 


度 定制 的 方法 ， 如 果 我 们 需要 使 用 Web 页 面 来 实现 应 用 的 界面 ， 就 不 得 不 用 到 这 两 个 方法 。 重 写 指 的 是 对 内 嵌 浏览 器 原生 控件 的 定制 ， 比 
。 实 际 上 ，DemoWeb 网 页 界面 中 已 经 包含 了 WebView 内 说 浏览 器 控件 的 实例 ， 本 节 将 详细 介绍 这 两 个 重点 功能 。 


“ 重 写 ”和 “回调 ”的 用 法 是 对 WebView 内 嵌 浏 览 器 控件 深 


如 alert 弹 出 框 ; 而 回调 指 的 是 系统 利用 Javascript 脚 本 与 本 地 Java 方 法 逻辑 进行 相互 调 


录 下 的 index.php 文 件 ， 如 代码 清单 7-99 所 示 。 此 界面 的 显示 效果 


为 了 便于 大 家 理解 重 写 和 回调 两 大 功能 的 用 法 ， 我 们 先 来 观察 DemoWeb 内 嵌 网 页 的 HTML 代 码 ， 也 就 是 服务 端 项 目 www/website/ 


如 图 7-32 所 示 。 


代码 清单 7-99 


<a href="javascript:location.reload();">Reload</a><br/> 
<hr/> 


./demos/index.html"»JQuery Mobile</a><br/> 
<a href="./gomap.php">Map Demo</a> 


网 页 HTML 代 码 的 逻辑 很 简单 ， 我 们 把 页 面 中 的 5 个 链接 从 上 到 下 简介 如 下 : 


: Reload: 用 于 刷新 网 页 。 

: Test Alert: 用 于 测试 alert 弹 出 窗口 。 

: Test Callback: 用 于 测试 JavaSctipt 回 调 Java 方 法 。 

- jQuery Mobile: 跳 转 到 jQuery Mobile 网 页 版 UI 界 面 ， 详 情 请 见 6.8.1 节 。 


: Map Demo: 跳 转 到 网 页 地 图 实例 界面 。 


E 写 ”和 “回调 ”用 法 的 实例 。 当 我 们 点 击 “Test Alert” 链 接 时 ， 程 序 会 调用 JavaScript 的 alert 方 法 来 


[Pum 


本 节 中 ， 我 们 会 重点 关注 “Test Alert” 和 “Test Callback” 的 用 法 ， 因 为 这 两 个 链接 分 别 是 “ 


弹出 窗口 ， 并 打印 提示 文字 “Test Alert”， 显 示 效果 如 图 7-34 所 示 。 


当然 ， 这 里 的 alert 对 话 框 已 经 定制 过 了 ， 我 们 可 以 看 到 对 话 框 的 标题 已 经 是 定制 之 后 的 提示 文字 “Notification” ， 关 于 定制 的 逻辑 我 们 在 内 嵌 网 页 界面 的 控制 器 基 类 BaseUiWeb 中 的 startWebView 


方法 中 已 经 实现 了 ， 请 参考 代码 清单 7-100。 


Notification 


Test Alert 


7-34 Test Alert 点 击 效果 


代码 清单 7-100 


abstract public class BaseUiWeb extends BaseUi { 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public void startWebView() { T 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
webView.setWebChromeClient (new WebChromeClient () { ~ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
GOverride 
public boolean onJsAlert (WebView view, String url, String message, 
final JsResult result) ( 
// 自 定义 alert 弹 出 框 
new AlertDialog.Builder (BaseUiWeb.this) 
.SetTitle ("Notification") 
. setMessage (message) 
.setPositiveButton (android.R.string.ok, new AlertDialog. 
OnClickListener() ( 
GOverride 
public void onClick(DialogInterface dialog, int which) ( 
result.confirm(); 


} 
1 
.SetCancelable (false) 
.create () .Show () ; 
return true; 


n; 


http://www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


前 面 说 过 WebChromeClient 接 口 类 提供 了 一 系列 的 回调 方法 (如 表 7-12 所 示 ) 来 定制 WebView 控 件 ，startWebView 方 法 中 就 使 用 了 onJsAlert 方 法 来 


辑 ， 当 用 户 在 该 WebView 触 发 alert 弹 出 框 时 ， 程 序 将 会 弹出 一 个 AlertDialog 对 话 框 ， 效 果 如 图 7-34 所 示 。 


“ 重 写 ” 了 系统 的 alert 弹 出 框 ， 根 据 这 里 的 逻 


接 下 来 ,我 们 在 DemoWeb 界 面 里 点 击 “Test Callback" 链接， 这 个 动作 将 会 通过 javascript 方 法 demo.testCallBack 方 法 来 “回调 ”本 地 Java 方 法 中 的 逻辑 。 此 时 我 们 可 以 在 LogCat 日 志 窗口 中 看 到 
本 地 Java 方 法 testCallBack 中 打印 出 的 信息 。 如 图 7-35 所 示 。 


= Console 


Log 


| 


Android 应 用 中 的 回调 功能 是 通过 WebView 类 中 的 addjavascriptlnterface 方 法 来 实现 的 。 实 际 上 ， 在 之 前 介绍 的 DemoWeb 界 面 控制 器 类 中 已 经 包含 了 回调 功能 的 实现 逻辑 ， 参 考 代码 清单 7-96。 其 


Time pid tag Message 


96-05 02 254 DenoJds Test Ca 


图 7-35 Test Callback 点 击 效果 


中 的 DemojJs 类 就 是 我 们 自 定 义 的 回调 接口 类 ， 而 其 中 也 包含 了 testCallBack 方 法 的 逻辑 ， 即 在 日 志 窗口 中 打印 “Test Callback” 提 示 信 息 。 


7.11.5 ”网 页 地 图 实例 分 析 


内 庶 网 页 界面 在 实际 项 目 中 的 运用 还 是 非常 广泛 的 ， 特 别 适 用 于 那些 界面 效果 要 求 不 高 但 是 却 可 能 更 改 频繁 的 界面 ， 比 如 说 使 用 说 明 、 消 息 公告 等 。 ME 


可 以 通过 WebView 内 谋 浏 览 器 加 入 到 Android 应 用 中 来 ， 当 然 也 包括 寺 


llback 


Ei 论 上 讲 ， 所 有 在 Web 界 面 上 可 以 实现 的 功能 都 


过 与 Google 地 图 的 网 页 版 API 的 结合 来 作为 这 种 用 法 的 实例 。 网 页 地 图 实例 的 界面 控制 器 DemoMap 和 DemoWeb 在 同一 个 类 包 下 ， 实 现 逻 辑 请 参考 代码 清单 7-101。 


代码 清单 7-101 


F 富 多 彩 的 互联 网 应 用 。 随 着 移动 互联 网 越 来 越发 达 ， 相 信 这 种 使 用 内 赃 网 页 引入 互联 网 应 用 的 方式 会 被 越 来 越 多 地 使 用 到 。 本 节 将 通 


packag 
import 
import 
import 
import 
import 
public 


e com.app.demos .demo; 
android.webkit .WebView; 
android.webkit .WebViewClient; 
com. app.demos .R; 
com. app. demos .base.BaseUiWeb; 
com. app. demos .base.C; 
class DemoMap extends BaseUiWeb ( 


private WebView mWebViewMap; 


public void onStart( 


GOverride 
) í 
super.onStart () ; 
setContentView(R.layout.demo_map) ; 
mWebViewMap = (WebView) findViewById(R.id.web map); 
mWebViewMap.getSettings () . setJavaScriptEnabled (true) ; 
mWebViewMap.setWebViewClient (new WebViewClient () { 
GOverride 
public void onPageFinished(WebView view, String url) { 
// 页 面 加 载 结 束 后 调用 javascript 方 法 设置 地 图 PORE 
mWebViewMap .loadUrl ("javascript:centerAt (39.907325,116.391455) ;"); 
} 
B: 
mWebViewMap. loadUr1 (C. web. gomap) ; 
this.setWebView (mWebViewMap) ; 
this.startWebView(); 


Demo! 


fehttp://127.0.0.1: 8002/gomap.php， 相 关内 容 可 参考 6.8.2 节 ; 其 二 ， 使 用 了 WebViewClient 回 调 接口 ， 并 在 onPageFinished 方 法 中 加 入 了 centerAt 方 法 的 回 


Map 同 样 继承 自 BaseUiWeb 基 类 ， 实 现 逻 辑 和 DemoWeb 差 不 多 。 不 同 之 处 主要 有 两 点 : 其 一 ， 加 载 的 网 页 地 址 不 同 ， 这 里 加 载 的 是 网 页 版 地 图 API 接 口 的 地 址 , 凤 


网 页 版 地 图 


API 接 口 的 介绍 中 可 以 看 出 ， 地 图 默认 是 以 陆 家 哗 为 中 心 的， 如 图 6-6 所 示 ; 但 是 ， 这 里 我 们 通过 本 地 Java 方 法 中 的 逻辑 把 中 心 点 设置 到 了 北京 天 安 门 ， 显 示 效果 如 图 


C.web.gomap 的 值 ， 也 就 


调 逻 辑 ， 用 于 设置 地 图 的 中 心 位 置 。 从 对 


7-36 所 示 。 
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图 7-36 ”网 页 地 图 运行 效果 


当然 ， 地 图 应 用 只 是 众多 互联 网 应 用 中 的 一 员 ; 通过 WebView 控 件 ， 我 们 可 以 把 丰富 多 彩 的 互联 网 世界 集成 到 Android 应 用 中 来 ， 同 时 还 能 比较 好 地 解决 跨 平台 的 问题 ， 是 非常 好 的 一 种 开发 思路 。 


是 ， 需 要 注意 的 是 ， 这 种 方式 必须 在 设备 联 


742 We 


本 章 是 本 书 的 核心 章节 ， 内 容 涵盖 了 Android 应 


网 的 情况 下 才能 生效 ， 另 外 还 有 可 能 遇 到 网 络 流量 过 大 的 问题 ， 因 此 我 们 需要 根据 具体 的 情况 选择 最 合适 的 方式 。 在 实际 项 目 中 ， 我 们 经 常会 采 
内 嵌 网 页 相 结合 的 方式 来 开发 Android 应 用 。 


开发 的 主要 知识 点 ， 从 程序 设计 到 界面 开发 ， 从 基本 用 法 到 进 阶 运用 等 。 从 中 我 们 不 仅 可 以 获得 Android 应 | 


目 中 程序 框架 的 设计 思路 。 在 介绍 微 博 应 用 客户 端 代 码 实现 的 同时 ， 还 按照 知识 点 分 类 的 思路 ,介绍 了 开发 过 程 中 可 能 涉及 的 方方面面 ， 让 理论 与 实践 深度 结合 ， 以 达到 最 好 的 学 习 效 果 。 


但 


Android UI 和 


开发 实战 的 宝贵 经 验 ， 还 可 以 学 到 实际 项 


至 此 我 们 已 经 把 微 博 应 用 服务 端 和 客户 端的 所 有 功能 全 部 开发 完了 ， 大 家 可 以 把 完成 的 微 博客 户 端 安装 到 手机 上 ， 好 好 自我 欣赏 和 陶醉 一 下 。 与 此 同时 ， 当 然 也 不 要 忘 了 闭 上 眼睛 ， 回 顾 和 体会 本 


的 


知识 ， 把 Android 应 用 开发 之 中 的 理论 和 实践 融会 贯通 。 也 许 你 的 思路 内 然 开朗 ， 甚 至 进发 出 新 的 创意 ， 然 后 又 动手 进行 二 次 开发 。 如 果 能 做 到 这 一 步 ， 那 么 恭喜 ， 你 已 经 正式 加 入 到 Android 开 发 者 阵 莒 中 
来 了 。 
另外 ， 本 章 的 知识 点 较 多 、 内 容 涉及 面 较 广 ， 实 例 代 码 也 比较 接近 于 实际 项 目 ， 学 习 难度 比较 大 ， 甚 至 可 能 会 有 部 分 读者 觉得 其 中 某 些 内 容 深奥 难 懂 。 因 此 ， 我 建议 大 家 最 好 能 对 照 微 博 实例 项 目的 源 


代码 进行 学 习 。 当 然 ， 在 学 习 的 同时 ， 最 好 还 能 动手 尝试 对 某 些 代 码 进行 二 次 开发 和 调试 ， 这 样 可 以 进一步 加 深 我 们 对 Android 应 用 开发 的 认识 。 


第 三 篇 ”优化 篇 


通过 前 两 篇 内 容 的 介绍 ， 我 们 已 经 把 微 
无 疑问 ， 后 面 还 会 有 很 多 的 地 方 需要 我 们 来 


博 应 用 实例 的 功能 逻辑 全 部 开发 完毕 。 但 这 是 否 意味 着 微 博 项 目 开发 进程 就 到 此 为 止 了 呢 ? 事实 上 却 恰恰 相 


完善 ， 也 会 有 更 多 的 版 本 等 待 着 我 们 来 发 布 。 


在 实际 项 目 中 ， 开 发 完成 之 后 至 少 还 需 
在 这 里 讨论 了 ， 本 篇 要 给 大 家 介绍 的 就 是 对 


第 8 章 性 能 分 析 


要 通过 “功能 测试 ”和 “压力 测试 ”两 个 步骤 ， 才 可 能 具备 可 以 上 线 的 条 件 。 而 在 这 个 过 程 中 ， 
于 开发 人 员 来 说 最 需要 引起 注意 的 性 能 优化 问题 。 


， 我 们 之 前 所 做 的 ， 都 只 是 “ 微 博 1.0” 的 开发 ， 


= 


我 们 还 有 很 多 的 修改 和 优化 工作 要 做 ， 功 能 方面 的 问题 我 们 就 不 


是 评估 应 用 软件 质量 


E 
HE 
ae 
| 
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的 重要 标准 之 一 ， 特 别 对 于 技术 团队 来 说 ， 应 该 说 应 用 产品 的 性 能 是 否 出 色 ， 是 考验 一 个 技术 团 


会 有 专门 的 人 员 负 责 应 用 性 能 分 析 的 事情 ， 
团队 中 的 每 个 开发 人 员 都 要 学 


8.1 关于 性 能 测试 


性 能 测试 是 一 个 较 大 的 范畴 ， 包 括 负载 
些 数据 来 对 产品 的 性 能 进行 评估 ， 进 而 制订 


8.1.1 ”服务 端 压力 测试 


随 着 互联 网 应 用 的 发 展 ， 应 用 服务 端的 
端 ”， 实 际 上 这 都 是 对 应 用 服务 端 性 能 的 考 


队 是 否 优秀 的 最 重要 标准 之 一 。 当 然 ， 一 般 来 说 在 项 目 团队 中 都 
但 是 这 并 不 意味 着 其 他 的 开发 人 员 就 不 需要 了 解 应 用 性 能 优化 的 知识 ， 根 据 作者 多 年 的 经 验 来 看 ， 很 多 的 性 能 问题 都 是 源 自 开 发 过 程 中 所 发 生 的 一 些 “ 小 问 


习 和 了 解 “性 能 优化 ”部 分 的 知识 ， 并 且 在 平时 开发 的 过 程 中 重视 起 来 ， 防 微 杜 淅 ， 这 才 是 高 品质 应 用 产品 的 开发 之 道 。 


测试 、 压 力 测试 和 容量 测试 ， 而 压力 测试 是 其 中 重点 所 在 。 压 力 测试 的 目的 是 通过 模拟 的 手段 来 对 目标 产品 进行 测试 ， 从 而 得 出 一 些 量化 的 数据 ， 我 们 将 通过 这 


下 一 步 优化 的 目标 和 策略 。 当 然 ， 对 于 服务 端 和 客 


在 实际 应 用 中 ， 服 务 端 API 接 口 可 能 会 


就 是 用 户 登录 接口 ( 详 见 6.2.1 节 ) ， 该 接 


结构 越 来 越 复杂 ， 需 要 支撑 的 访问 量 也 越 来 越 庞 大 ， 因 此 服务 端的 性 能 问题 也 会 越 来 越 凸 显 。 特 别 对 于 现在 的 互联 网 应 
验 。 回 到 我 们 的 微 博 应 用 来 看 ， 服 务 端的 接口 都 是 建立 在 HTTP 协 议 上 的 ， 而 我 们 需要 测试 的 目标 接口 就 是 第 6 章 中 所 介绍 到 的 那些 API 接 口 。 


FE 常 多 ， 所 以 我 们 需要 从 中 挑选 出 一 些 可 能 造成 性 能 瓶颈 的 接口 来 进行 测试 。 考 虑 到 篇 幅 的 因素 ， 


户 端 来 说 ， 性 能 测试 的 具体 方法 一 定 是 不 同 的 ， 但 是 大 体 思 路 还 是 非常 类 似 的 ， 而 这 也 是 本 章 我 们 需要 学 习 和 


来 说 ， 越 来 越 多 的 数据 被 存储 到 “ 云 


本 节 中 我 们 只 会 挑选 一 个 接口 作为 压力 测试 的 案例 ， 而 这 个 接 


对 应 的 URL 地 址 是 /index/login。 我 们 做 这 个 选择 的 原因 有 两 个 : 其 一 是 登录 接口 是 微 博 应 用 的 总 入 口 ， 访 问 的 频率 是 非常 高 的 ， 另 外 ， 登 录 动 作对 于 用 户 体验 


来 说 是 非常 重要 的 ， 实 际 上 登录 接口 是 绝 大 


可 用 于 服务 端 压力 测试 的 工具 非常 多 ， 


部 分 网 络 应 用 的 “ 必 测 接口 ”之 一 。 


包括 LoadRunner、http_load、JMeter、Apache ab 等 。 其 中 比较 适合 在 开发 中 使 用 的 两 种 工 


运用 这 两 种 工具 对 登录 接口 进行 压力 测试 和 


1. 使 用 Apache ab 


结果 分 析 。 


是 Apache ab 和 JMeter， 下 面 我 们 便 来 学 习 如 何在 微 博 实例 中 


Apache ab 是 Apache 服 务 器 自 带 的 压力 测试 工具 ， 其 特点 是 功能 简单 ， 实 用 性 强 ， 只 要 我 们 安装 了 Apache 服 务 器 ， 就 可 以 在 它 主 目录 之 下 的 bin/ 目 录 里 找到 这 个 命令 行 工 具 ， 当 然 Xampp 环 境 里 也 包 
含 了 这 个 工具 ， 我 们 一 般 会 把 Xampp 目 录 下 的 apache/bin/ 目 录 加 入 系统 的 环境 变量 (Path) 中 ， 这 样 打开 命令 行 终端 就 可 以 直接 输入 ab 命令 来 操作 了 ， 默 认 不 带 参数 就 是 打印 帮助 信息 ， 运 行 效果 如 


1 所 示 。 
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8-1 ab 命 令 运 行 效果 


ab 命 令 中 比较 重要 的 几 个 参数 有 : 总 请 求 数 Cn) ， 并 发 请 求 数 (-c) ，POST 请 求 文件 (-p) ，POST 请 求 头 (-T) 以 及 KeepAlive 开 关 等 。 我 们 通常 会 使 


10 个 并 发 完成 100 个 请 求 的 方式 来 粗略 计 


算 普 通 接口 的 性 能 ， 命 令 行 如 “ab-n 100-c 10http://hostname/path” , 


考虑 到 微 博 应 用 的 登录 流程 ， 我 们 需要 对 登录 接口 做 两 方面 的 测试 。 首 先 ， 是 对 不 含 参 数 的 URL， 即 http://localhost: 8001/index/login 来 测试 ， 这 种 情况 实际 上 是 用 户 首次 请 求 的 情况 。 因 为 在 正常 


逻辑 下 ， 客 户 端 首次 请 求 后 就 能 获得 当前 会 话 的 会 话 ID (也 称 为 Session ID) ， 而 后 的 每 次 访问 都 会 使 


当前 的 会 话 (Session) ， 直 至 会 话 失效 。 由 于 ab 工具 并 不 是 客户 端 ， 没 有 办 法 保存 Session ID, PF 


以 这 种 情况 下 ， 每 次 访问 系统 都 会 产生 新 的 Session 会 话 ， 这 正好 可 以 用 


于 测试 Session 会 话 系统 的 性 能 ， 


测试 结果 如 图 8-2 所 示 。 


= CIXANINDONWSAeystem32Xcmidl. exe 
"Jab -niBH -c1B http:22427.0.ñ.1:BBBl/index/login 
his is ñpacheBench. Uerziun 2.3 ¢{$Revision: 655654 5» 


opuright 1796 Adam Twiss, Zeus Technology Ltd, http? //wmw.zeustech. net’ 
icented to The Apache Software Foundation. http://uww.apache. org” 


Benchmarking 127.0.0.1 (he patient?.....done 


Berpyer Software = Apache -2.2.17 
Gerver Hort name = 127.0.0.1 
Beever Port: EnH 


Document Path: findex- login 
Document Length: iñé bites 


oncurrency Lepal: iH 
ing taken for tests: 1.264 seconds 
onplcte requests: iHH 
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rite &rFrürz: Bñ 
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TAL trantferred= 1060A bytes 
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B H 1.6 u 15 
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63 ii? 20.8 104 18H 
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图 8-2 ”使 用 ab 测 试 登录 接口 
一 般 来 说 ， 压 力 测试 需要 运行 一 定 的 时 间 ， 等 待 测试 完成 之 后 ， 就 可 以 看 到 压力 测试 的 结果 。 参 照 之 前 的 压力 测试 结果 ， 我 们 来 简单 介绍 一 下 ab 测试 结果 中 需要 我 们 重点 关注 的 数据 。 
: Total transferred: 整个 场景 中 的 网 络 传输 量 ， 单 位 字 节 。 
: Requests per second: 每 秒 处 理 请 求 数 ， 即 每 秒 事务 数 (简称 TPS) 。 该 数据 可 以 很 大 程度 上 体现 该 接口 的 性 能 ， 一 般 来 说 100~200 是 比较 理想 的 情况 。 
: Time per request: 每 个 请 求 花费 的 时 间 ， 即 平均 事务 响应 时 间 。 此 数值 在 结果 中 有 两 行 ， 而 我 们 通常 更 关注 后 一 行 的 数值 ， 也 就 是 计算 所 有 并 发 请 求 后 的 平均 响应 时 间 。 
: Transfer rate: 平均 每 秒 网 络 上 的 流量 ， 此 数据 可 帮助 排除 是 否 存 在 网 络 流量 过 大 导致 响应 时 间 延 长 的 问题 。 


接 下 来 ， 我 们 来 测试 在 用 户 正常 登录 的 情况 下 登录 接口 的 性 能 。 在 这 种 情况 下 ， 我 们 把 Session 1D 传 给 服务 器 ， 此 时 系统 就 不 会 重复 创建 session 会 话 ; 另外 ， 我 们 要 使 用 POST 方法 来 请 求 数据 ， 因 此 
需要 把 POST 的 数据 保存 在 一 个 文件 (比如 D 盘 下 的 post.txt) 中 ， 内 容 如 下 “name=james&pass=james”， 然 后 输入 对 应 的 ab 命令 来 完成 测试 ， 具 体 的 命令 行 以 及 测试 结果 如 图 8-3 所 示 。 


小 贴 士 : 我 们 可 以 通过 调试 后 台 来 获取 Session ID ， 登 录 之 后 随便 打开 某 个 接口 测试 界面 ， 即 可 在 action 栏 中 找到 Session ID 的 值 ， 如 登录 接口 中 action 的 对 应 字符 事 是 : /index/login? sid=xxx&, sid KAY 


内 容 就 是 Session ID。 


—É—— 2thdg ila 

This iz ApacheBench, Version 2.3 $5Revizion: 655654 57 

Copyright 1995 Adam Tuiss, Zeus Technology Ltd. httpgzz^wwuu.zcustech.net. 
Licensed to Ihe Apache Software Foundation, http: A wuwu.: apache. name 


! lenchmarking localhost the patient?.....done 


Peeve oftware: Apaches .2.17 
Server Hastnanme: localhost 
Server Port: ENEL 


Document Path: FjJindexzlogin?zid-ytknl1742rr5ds4f151uann152thüdg;jHa 
Document Length: 186 bytes 


Concurrency Level: 1H 
ime taken for tests: |L SAA seconds 
Complete requests, = iua 
Failed reguests: H 
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图 8-3 ”使 用 ab 测 试 成 功 登 录 的 情况 


通过 对 测试 结果 的 分 析 ， 我 们 得 出 结论 : 在 正常 登录 的 情况 下 ， 每 秒 事务 数 略 低 、 平 均 事务 响应 时 间 略 高 ， 这 表明 这 种 情况 下 的 系统 性 能 略 低 于 首次 访问 的 情况 。 原 因 很 简单 ， 这 是 因为 正常 登录 的 逻 
辑 要 比 首次 访问 复杂 得 多 。 一 般 来 说 ， 系 统 的 性 能 和 逻辑 的 复杂 度 成 反比 ， 这 点 我 们 必须 注意 ， 特 别 在 做 功能 设计 时 ， 我 们 要 注意 在 功能 和 性 能 问题 上 进行 取舍 。 


JMeter 实 际 上 也 属于 Apache Group， 是 一 个 基于 Java 的 压力 测试 工具 ， 大 家 可 以 从 它 的 官方 网 站 (| /) 上 获取 最 新 版 本 的 JMeter 工 具 。JMeter 提 供 比 Apache ab 更 加 丰富 
的 压力 测试 工具 ， 以 及 多 机 联合 测试 等 更 高 级 的 功能 。 接 下 来 我 们 将 通过 JMeter 来 测试 登录 接口 中 首次 访问 和 正常 登录 两 种 情况 。 


我 们 使 用 的 是 JMeter 2.4 版 本 ， 下 载 解压 之 后 ， 进 入 主 目录 下 的 可 执行 文件 目录 bin/ 中 ， 双 击 imeter.bat (Linux 系 统 下 则 是 jimeter.sh) 文件 ， 即 可 打开 JMeter 主 界面 ; 接着 ， 我 们 需要 根据 具体 的 测 
试 需求 来 配置 对 应 的 测试 计划 。 


首先 ， 右 键 单 击 “ 测 试 计划 ”， 在 弹出 的 快捷 菜单 中 的 “添加 ”菜单 中 选择 “Threads (Users) ” 子 菜单 中 的 “线程 组 ”， 添 加 一 个 线程 组 ， 我 们 知道 压力 测试 的 请 求 都 是 并 发 的 ， 线 程 组 就 是 用 来 控 
制 并 发 数 的 ， 这 里 配置 线程 数 为 10， 循 环 次 数 为 10， 即 总 共 100 次 请 求 ， 和 之 前 的 ab 测试 一 样 ， 效 果 如 图 8-4 所 示 。 


ES ]nzir- Jax (D:\program\Jecter\bin\login. jax) 


运行 


Apache JWeter (2.4 r961953) 
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图 8-4 ”在 JMeter 中 配置 线程 组 


然后 ， 右 键 单 击 线程 组 ， 从 “添加 ”菜单 的 子 菜单 中 找到 并 选中 “HTTP 请 求 默认 值 ”、“HTTP 请 求 ”、 


“察看 结果 树 ” 和 “聚合 报告 ”等 配置 项 ， 这 些 配 置 项 是 JMeter 中 最 常用 到 的 测试 组 件 ， 下 面 
我 们 将 依次 介绍 它们 的 用 法 。 


HTTP 请 求 默 认 值 : 位 于 “配置 元 件 ” 菜 单 中 ， 用 于 设置 HTTP 请 求 的 通用 参数 ， 比 如 服务 器 IP 和 端口 号 、HTTP 请 求 头 以 及 代理 服务 器 设置 等 。 
HTTP 请 求 : 位 于 “Sampler” 菜 单 中 ， 用 于 设置 具体 的 HTTP 请 求 的 参数 ， 比 如 请 求 路 径 、 请 求 参 数 、 请 求 附带 的 文件 等 。 


察看 结果 树 : 位 于 “监听 器 ”菜单 中 ， 用 于 查看 HTTP 请 求 的 具体 返回 ， 一 般 来 说 我 们 在 压力 测试 之 前 会 通过 该 工具 来 确认 一 下 请 求 的 返回 值 是 否 正确 ， 如 果 返 回 值 和 我 们 预期 不 一 样 就 需要 重新 检查 
压力 测试 的 配置 项 是 否 有 误 。 


“ 聚合 报告 : 位 于 “监听 器 ”菜单 中 ， 用 于 查看 压力 测试 的 综合 结果 ， 包 含 每 秒 事务 数 、 平 均 事务 响应 时 间 、 知 吐 量 等 


EE. 
回 到 微 博 应 用 的 压力 测试 案例 ， 由 于 我 们 的 AP| 接 


口 都 存在 于 127.0.0.1 域 名 的 8001 端 口 之 下 ， 所 以 我 们 在 HTTP 请 求 默认 值 中 也 做 了 相应 的 设置 ， 如 图 8-5 所 示 。 
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图 8-5 JMeter 中 配置 HTTP 请 求 默认 值 


此 外 ， 我 们 还 添加 了 两 个 HTTP 请 求 “login1” 与 “Ilogin2”， 分 别 对 应 于 登录 接口 的 首次 访问 和 正常 登录 两 种 情况 。 我 们 先 来 看 一 下 首次 访问 ， 即 login1 中 的 配置 详情 ， 请 求 方法 为 默认 的 “GET” 方 


法 ， 请 求 路 径 为 index/login”， 如 图 8-6 所 示 。 
ES login. jmx (D:\program\iecter\bin\login. jax) Apache JMeter (2.4 r961953) 
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图 8-6 ”使 用 JMetet 测 试 登录 接口 


接 下 来 我 们 通过 “添加 ”菜单 来 添加 察看 结果 树 和 聚合 报告 两 个 测试 组 件 ， 然 后 通过 察看 结果 树 组 件 验证 HTTP 请 求 的 返回 是 否 正 确 。 验 证 通过 之 后 ， 我 们 先 屏蔽 不 需要 使 用 的 配置 ， 即 依次 右键 单 击 
login2 和 察看 结果 树 ， 选 择 “禁用 ”选项 ， 当 看 到 配置 项 变 成 灰色 时 (如 图 8-6 所 示 ) 则 表示 禁用 成 功 。 然 后 ， 就 可 以 单 击 顶 部 “运行 ”菜单 下 的 “启动 ”选项 来 启动 压力 测试 ， 压 力 测试 的 结果 如 图 8-7 所 
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图 8-7 JMeter 中 登录 接口 的 测试 结果 


如 果 把 JMeter 聚 合 报告 里 面 的 数据 项 和 ab 工具 测试 结果 做 一 下 比较 ， 我 们 会 发 现 两 者 之 间 的 区 别 非常 小 ， 下 面 我 们 来 列举 JMeter 测 试 结 果 中 重要 数值 的 说 明 。 
: #Samples: 测试 完成 总 事务 数 。 
. Average: 平均 请 求 响应 时 间 。 
: Median: 统计 意义 上 的 响应 时 间 平 均值 。 


- 9096Line: 除 特 殊 情 况 之 外 的 最 大 响应 时 间 。 


: Min: 最 短 响应 时 间 (单位 ms) 。 
| Max: 最 长 响应 时 间 (单位 ms) 。 
“ Error%: 出 错 率 ， 若 出 现 则 表示 网 络 环境 有 问题 。 


: Throughput: 吞吐 量 (TPS) ， 和 ab 中 的 每 秒 处 理 请 求 数 类 似 。 


: KB/sec: 流量 (KBs) ， 衡 量 服务 器 性 能 的 重要 指标 。 


另外 ， 从 图 8-7 所 示 的 压力 测试 结果 中 可 以 看 出 ， 在 登录 接口 首次 访问 时 ，JMeter 的 测试 结果 和 ab 工具 的 测试 结果 是 非常 类 似 的， 这 种 情况 表明 ， 上 述 测试 结果 的 准确 度 是 比较 高 的 。 


接 下 来 ， 我 们 再 来 看 看 另外 一 种 情况 ， 也 就 是 正常 登录 情况 下 的 配置 。 此 配置 名 为 login2， 具 体 配 置信 息 如 图 8-8 所 示 ， 请 求 方法 为 POST， 请 求 路 径 (包含 Session ID) 
为 /index/login? sid=auouaqu6me46u3giedtbkbddk30o8gpe， 另 外 发 送 的 参数 name 和 pass 的 值 均 为 ames， 发 送 验证 成 功 之 后 ， 禁 用 login1 和 察看 结果 树 ， 即 可 开始 压力 测试 ， 最 终结 果 如 图 8-9 所 
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图 8-8 JMeter 中 配置 成 功 登 录 的 情况 
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图 8-9 JMeter 中 成 功 登 录 的 测试 结果 


从 正常 登录 情况 的 压力 测试 结果 看 来 ， 其 性 能 比 之 前 首次 登录 时 略 差 ， 这 点 和 之 前 ab 工具 的 测试 结果 一 致 ， 不 过 具体 的 吞吐 量 数值 有 些 差 距 ， 这 和 进行 压力 测试 时 的 运行 环境 有 一 些 关 系 ， 其 实 每 个 压 
力 测试 工具 的 结果 都 可 能 存在 偏差 ， 对 于 我 们 来 说 主要 目的 是 要 通过 测试 结果 的 数据 找 出 程序 逻辑 中 的 问题 。 


最 后 ， 我 们 还 需要 注意 进行 服务 端 性 能 测试 的 几 个 注意 事项 : 首先 ， 性 能 测试 最 好 在 本 地 进行 ， 至 少 也 要 保证 服务 器 和 测试 机 都 在 内 网 中 ， 这 样 才能 排除 网 络 的 干扰 因素 ， 更 准确 地 测试 出 系统 本 身 的 
问题 ; 其 次 ， 必 须根 据 服 务 端 应 用 的 实际 情况 选用 合适 的 输入 参数 ， 最 好 是 能 预 估 出 与 目标 性 能 相符 的 测试 ， 让 测试 的 结果 更 有 针对 性 。 


8.1.2 ”客户 端 性 能 测试 


客户 端 与 服务 端 在 移动 应 用 架构 中 的 分 工 不 同 ， 因 此 性 能 测试 的 标准 也 必然 大 相 径 庭 。 对 于 服务 端 来 说， 我 们 比较 关心 服务 端的 承载 量 ， 因 此 在 服务 端的 性 能 测试 中 更 需要 关注 压力 测试 的 结果 ; 而 对 
于 客户 端 来 说 ,我 们 更 关心 客户 端 运 行 的 稳定 和 流畅 度 ， 因 此 在 客户 端的 性 能 测试 中 ， 更 侧重 于 稳定 性 测试 和 内 存 测试 ， 当 然 对 于 网 络 应 用 来 说 还 有 流量 测试 。 


首先 ， 在 稳定 性 测试 中 ， 我 们 可 以 停止 设备 的 待机 或 者 屏保 ， 让 应 用 尽 可 能 长 时 间 地 运行 ， 并 观测 应 用 在 运行 过 程 中 的 出 错 率 ， 性 能 劣化 趋势 等 。 进 行 稳定 性 测试 时 需要 注意 三 点 : 一 是 运行 时 间 要 尽 
可 能 长 ， 二 是 运行 时 保持 多 线程 的 运行 状态 ， 三 是 使 用 尽 可 能 多 的 机 型 或 者 操作 系统 来 进行 测试 。 稳 定性 测试 还 需要 用 到 一 些 调试 工具 ， 比 如 7.1.3 节 所 介绍 的 DDMS 工 具 中 的 内 存 查看 器 (Heap) 就 可 以 
随时 获取 即时 的 设备 内 存 详情 ， 以 便 在 稳定 性 出 现 问题 时 及 时 地 发 现 原因 所 在 。 


P 


其 次 ， 对 于 内 存 测 试 来 说 ,我 们 也 可 以 使 用 更 直接 的 方式 来 进行 ， 也 就 是 将 测试 代码 嵌入 应 用 程序 中 进行 输出 观察 。 如 代码 清单 8-1 所 示 ， 我 们 在 微 博 应 用 客户 端的 基 类 BaseUi 中 嵌入 了 
debugMemory 方 法 来 打印 应 用 程序 运行 时 内 存 的 占用 情况 。 此 外 ， 该 方法 还 使 用 了 工具 类 AppUtil 中 的 getUsedMemory 方 法 来 获取 准确 的 内 存 占 用 。 


代码 清单 “8-1 


public class BaseUi extends Activity { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
// 打印 当前 使 用 内 存 
debugMemory ("onCreate") ; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
š 
GOverride 
protected void onResume() { 
super.onResume () ; 
debugMemory ("onResume") ; 
} 
GOverride 
protected void onPause() ( 
super.onPause(); 
debugMemory ("onPause") ; 
} 
GOverride 
public void onStart() ( 
super.onStart (); 
debugMemory ("onStart") ; 
l 
GOverride 
public void onStop() ( 
super.onStop(); 
debugMemory ("onStop") ; 
} 
public void debugMemory (String tag) { 
if (this.showDebugMsg) { 
Log.w(this.getClass().getSimpleName(), tag+":"+AppUtil.getUsedMemory () ) ; 
} 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


从 以 上 代码 中 可 以 看 到 ， 我 们 在 界面 控制 器 基 类 中 的 几 个 与 Activity 生 命 周期 有 关 的 方法 中 都 嵌入 了 内 存 查 看 方法 debugMemory， 这 样 理论 上 应 用 所 有 的 界面 运行 时 我 们 都 可 以 很 方便 地 观察 到 最 即 
时 、 最 准确 的 内 存 使 用 状况 。 比 如 ， 在 从 登录 界面 进入 微 博 列 表 的 过 程 中 ， 我 们 可 以 观察 LogCat 日 志 信息 ， 如 图 8-10 所 示 。 


E Console 


Message 
05-11 01:42 po og AppClient.pcst.result ("code": "10000" , "nessage' 


05-11 01: du ActivityManager Starting activity: Intent 
05-11 01:42 Ee 3 àpplogin onPause : 2915896 

05-11 01 j Appindex onCreate:2919312 

05—11 01:4: í àpplndex onGtart:2940443 

05-11 01 ii àppindex onRezsume:29196854 


图 8-10 ”使 用 LogCat 观 察 内 存 使 用 


从 以 上 日 志 界面 截图 中 ， 我 们 可 以 清楚 地 观察 到 界面 切换 时 Activity 各 生命 周期 方法 的 调用 情况 ， 以 及 内 存 使 用 的 变化 详情 。 首 先 ， 当 登录 成 功 以 后 ， 登 录 界 面 的 Activity 对 象 AppLogin 被 销毁 ， 同 时 调 
了 该 对 象 的 onPause 方 法 ; 然后 ， 微 博 列表 界面 的 Activity 对 象 Applndex 被 创建 ， 依 次 调用 了 该 对 象 的 onCreate、onStart 和 onResume 方 法 ; 此外， 日志 中 打印 出 的 方法 名 的 右 侧 数字 代表 的 就 是 当时 
的 内 存 使 用 数 (单位 比特 ) 。 


但 是 ， 如 果 要 测试 与 界面 无 关 的 逻辑 时 ， 使 用 在 Activity 里 嵌入 调试 逻辑 的 方式 就 不 大 方便 了 。 此 时 ， 我 们 需要 用 到 AOP 面 向 切面 编程 的 思路 ， 使 用 Java 映 射 类 包 中 的 拦截 器 接口 InvocationHandler 来 
实现 测试 目标 的 动态 代理 类 ， 进 而 帮助 我 们 测试 目标 代码 。 在 微 博 实例 源码 的 测试 包 com.app.demos.test 中 我 们 可 以 找到 可 用 于 代码 测试 的 代理 类 的 实例 ， 即 TestProxyjava， 如 代码 清单 8-2 所 示 。 


小 贴 士 : AOP (Aspect Oriented Programming， 面 向 切面 编程 ) 是 Spring 框 架 的 核心 编程 思想 之 一 ， 其 目的 是 把 菜 些 具 有 切面 特征 的 功能 (如 日 志 记 录 、 性 能 分 析 、 安 全 控制 、 异 常 处 理 等 ) 从 业务 逻辑 中 
剥离 出 来 。 这 里 我 们 正好 利用 该 思想 来 完成 与 程序 性 能 测试 有 关 的 功能 。 


代码 清单 8-2 


package com.app.demos.test; 
import java.lang.reflect.InvocationHandler; 
import java.lang. reflect .Method; 
import java.lang.reflect. Proxy; 
import com.app.demos.util.AppUtil; 
public class TestProxy implements InvocationHandler { 
Object testObj; 
public TestProxy (Object obj) { 
testObj = obj; 


public static Object init (Object obj) ( 
return Proxy.newProxyInstance( 
obj.getClass().getClassLoader(), 
obj.getClass().getInterfaces(), 
new TestProxy (obj) ); 
} 
GOverride 
public Object invoke (Object proxy, Method method, Object[] args) 
throws Throwable ( 
Object methodResult; 
try { 
System.out.println("method name : " + method.getName ()); 
long startTime = AppUtil.getTimeMillis(); 
methodResult = method.invoke (testObj, args); 
long endTime = AppUtil.getTimeMillis(); 


System.out.println("method time : " + (endTime - startTime) + "ms"); 
) catch (Exception e) ( 
throw new RuntimeException("TestHandler Exception : " + e.getMessage()); 


) 


return methodResult; 


TestProxy 类 实现 了 InvocationHandler 接 口 的 invoke 方 法 ， 该 方法 用 于 拦截 代理 对 象 的 方法 调用 。init 方 法 用 于 创建 并 返 
拦截 ， 记 录 了 方法 执行 的 前 后 时 间 ， 并 打印 出 执行 的 方法 名 和 执行 时 间 。 


回 


TestProxy 的 代理 对 象 ， 而 在 invoke 方 法 中 对 代理 对 象 方法 调用 的 时 候 进行 了 


例如 ， 需 要 测试 对 比 Java 数 组 和 ArrayList 列 表 的 效率 ， 我 们 就 可 以 使 用 以 下 方法 来 测试 。 首 先 ， 准 备 测试 接口 类 TestDemo， 如 代码 清单 8-3 所 示 。 


代码 清单 8-3 


package com.app.demos.test; 

public interface TestDemo { 
public void testArray(); 
public void testArrayList (); 


TestDemo 接 口 定义 了 两 个 接口 方法 ， 即 testArray 和 testArrayList， 用 于 测试 Java 数 组 和 ArrayList 列 表 的 逻辑 实现 。 接 下 来 的 步骤 就 是 实现 该 接口 ， 我 们 已 经 在 TestDemolmpl 类 中 实现 了 TestDemo 
接口 中 的 两 个 方法 ， 如 代码 清单 8-4 所 示 。 


代码 清单 8-4 


package com.app.demos.test; 
import java.util.ArrayList; 
import java.util.List; 
public class TestDemoImpl implements TestDemo { 
GOverride 
public void testArray() ( 
int[] array = new int[1000]; 
for (int i = 0; i < 1000; i++) { 
array[i] = i; 
} 
} 
GOverride 
public void testArrayList() { 
List<Integer> arrayList = new ArrayList<Integer>(); 
for (int i = 0; i < 1000; i++) { 
arrayList.add(i, i); 


} 


我 们 在 testArray 和 testArrayList 方 法 中 分 别 对 array 数 组 和 arrayList 列 表 对 象 进行 了 循环 1000 次 的 插入 操作 。 最 后 ， 在 TestUi 界 面 中 放置 两 个 Button 按 钮 分 别 用 于 触发 testArray 和 testArrayList 方 法 的 
逻辑 ， 如 代码 清单 8-5 所 示 。 


代码 清单 8-5 


package com.app.demos.test; 
import com.app.demos.R; 
import com.app.demos.base.BaseUi; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
public class TestUi extends BaseUi { 
final static int testArrayTask = 1; 
final static int testArrayListTask = 2; 
private Button btnTestArray = null; 
private Button btnArrayListTask = null; 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView(R.layout.ui test); 
btnTestArray = (Button) this.findViewById(R.id.app test btn test array); 
btnTestArray.setOnClickListener (new OnClickListener() { 
GOverride 
public void onClick(View v) ( 
doTaskAsync (testArrayTask, 0); 
} 
DE 
btnArrayListTask = (Button) this.findViewById(R.id.app test btn test array list); 
btnArrayListTask.setOnClickListener (new OnClickListener() ( 
GOverride 
public void onClick(View v) ( 
doTaskAsync (testArrayListTask, 0); 
} 
n; 
} 
public void onTaskComplete (int taskId) { 
super.onTaskComplete (taskId) ; 
switch (taskId) ( 
case testArrayTask: 
try { 
TestDemo td = (TestDemo) TestProxy.init (new TestDemoImpl()); 
td.testArray (); 
} catch (Exception e) { 
e.printStackTrace () ; 
} 
break; 
Case testArrayListTask: 
try { 
TestDemo td = (TestDemo) TestProxy.init (new TestDemoImpl()); 
td.testArrayList (); 
} catch (Exception e) { 
e.printStackTrace () ; 
} 


break; 


TestUi 界 面 的 模板 文件 为 ui_test.xml， 其 中 声明 了 两 个 按钮 ，Java 数 组 测试 按钮 “Test Array” 和 ArrayList 列 表 测 试 按钮 “Test Array List”， 界 面 如 图 8-11 所 示 。 在 TestUi 类 中 ， 我 们 分 别 为 以 上 两 个 
按钮 添加 了 不 同 的 异步 方法 ， 然 后 在 onTaskComplete 方 法 中 予以 实现 。 


AR) @ + 3:04 


Performance Tests: 


Test Array 


Test Array List 


分 别 单 击 两 个 按钮 ， 使 可 在 LogCat 日 5 


图 8-11 
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程序 的 性 能 


B6» 


Lagzmk A 


网 


中 看 到 打印 出 来 的 信息 ， 


[ Consele 


pid 
. £7É 
I. 276 
276 
2TÉ 


taq Hezsgaqe 

nethod nane 
nethod tina 
method nonc 
n=thod 


x 


tal .Dut 
LE . 
vsten 
Cys ten 


c 
lrs 
= 


"F 
lat 


v 
1 
y 


one 


oE eine 


图 8-12 ”客户 端 性 能 测试 结果 


8-12 所 示 。 我 们 可 以 看 到 testArray 方 法 的 执行 时 间 为 2ms， 而 testArrayList 方 法 的 执行 却 花 了 30ms， 这 样 就 可 以 很 清楚 地 看 


Leztáàrray 


在 程序 内 部 逻辑 细节 的 调试 中 ， 配 合 前 面 在 Activity 生 命 周期 中 埋 点 的 方法 ， 可 以 快速 准确 地 定位 程序 的 问题 所 在 。 此 外 ， 该 方法 还 可 以 用 于 选择 更 优 的 方法 来 提升 
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当 性 能 测试 的 结果 出 来 之 后 ， 我 们 通常 需要 根据 结果 进行 分 析 ， 找 出 应 


进 ， 上 线 之 后 可 能 会 造成 严重 的 负面 影响 。 对 于 移动 互联 网 应 


8.2.1 


对 于 移动 互联 网 应 责 的 
涉及 的 重要 组 件 ， 找 出 可 能 存在 的 性 能 瓶颈 。 


服务 端 瓶颈 分 析 


1. 服 务 器 


服务 器 的 
接 影响 到 客户 端的 响应 速度 ， 是 可 能 出 现 


2 .数据 库 


数据 库 


于 持久 


3. 代 码 程序 


代码 程序 位 于 服务 端 架 构 的 中 间 


一 的 整体 


E, 


Q& 


4 .网络 传输 


除了 上 述 应 


传输 出 了 


小 贴 士 : 服务 端 架 构 的 有 


以 上 


的 实现 就 更 是 大 相 径 庭 ; 


分 析 
2E 


= 
A, 


来 说 ， 服 务 端 负 


为 如 果 不 能 及 时 找 出 应 


性 能 的 瓶颈 所 在 ， 然 后 才能 进行 针对 性 的 优化 。 这 个 过 程 是 非常 重 
来 说 ， 可 能 出 现 瓶 颈 的 地 方 包含 服务 端 和 客户 端 两 个 方面 。 


的 内 容 应 该 是 从 接收 客户 端 请 求 并 进行 逻辑 处 理 直 至 把 返回 数据 返回 给 客户 端的 整个 过 程 。 服 务 端 通常 由 


EF 要 功能 是 为 服务 端 API 接 


提供 HTTP 服 务 ， 用 于 接收 请 求 (Request) 和 返回 结果 (Response) ， 位 于 服务 端 架构 的 最 外 


回 


层 ， 与 客户 端 网 络 组 件 直接 打交道 。 因 


层 的 数据 存储 ， 对 于 微 博 应 
关 ， 所 以 一 旦 数据 库 发 生 问题 ， 将 会 影响 到 大 部 分 的 服务 端 接口 


服务 端的 几 个 要 点 之 外 ， 客 


眶 颈 的 部 件 之 一 ， 相 关 优 化 方案 我 们 将 在 9.3.1 节 中 做 详细 介绍 。 


来 说 主 


于 存储 文章 和 用 户 的 数据 ， 它 位 于 服务 端 架构 的 最 里 层 。 
， 也 有 可 能 出 现 瓶 颈 ， 相 关 优 化 方案 我 们 将 在 9.3.2 节 中 介绍 。 


不 仅 所 有 的 功能 逻辑 都 是 使 


PHP 语 言 来 进行 服务 端 程序 开发 的 优化 要 点 ， 请 参考 9.1 


国 


内 相对 复杂 的 网 络 布 


户 端 与 服务 端 之 间 的 网 络 传输 也 是 不 得 不 考虑 的 一 个 可 能 存在 的 瓶颈 ， 尤 其 对 于 


问题 ， 整 个 移动 应 


都 有 可 能 


关内 容 可 


参考 4.5 节 应 用 架构 设计 部 分 的 内 容 ， 


名 入 崩溃 的 边缘 。 


服务 端 程序 架构 的 相关 内 容 可 参考 5.1 节 的 相关 内 容 。 


提 及 的 是 我 们 从 移动 互联 网 应 


民 务 端 性 能 瓶颈 


题 都 跟 数据 库 和 代码 逻辑 有 关 。 


另外 ， 由 于 本 书 讲 的 是 Android 和 PHP 相 结合 的 移动 互联 网 应 


8.2.2 ”客户 端 瓶颈 分 析 


此 外 我 们 


因此 ， 瓶 颈 出 现 的 位 置 和 方式 都 可 能 大 不 相同 ， 我 们 分 析 问题 时 需 


时 ， 我 们 可 以 按照 以 下 思路 进行 排查 。 首 先 ， 在 本 地 或 者 内 网 中 进行 压力 测试 ， 如 果 结果 很 理想 ， 那 么 基本 上 可 以 确定 是 网 络 方 | 


民 务 器 和 数据 库 的 运行 情况 ， 确 认 是 否 属于 硬件 问题 ， 若 不 是 ， 则 需要 根据 日 志 来 进行 更 深入 的 调查 。 如 果 仍 然 找 不 到 问题 所 在 ， 就 需要 检查 代码 了 。 根 据 实际 经 验 来 看 ， 大 部 分 的 


清楚 的 是 ， 不 同 移动 应 用 的 功能 特点 各 不 相同 ， 需 要 使 
自身 的 实际 情况 为 依据 ， 切 不 可 仅 凭 经 验 就 一 概 而 论 ， 否 则 


根据 应 


面 的 问题 ， 


的 性 能 瓶颈 ， 并 予以 改 


许多 不 同 的 独立 部 件 构成 ， 下 面 我 们 来 分 析 这 个 过 程 中 


此 ， 服 务 器 的 性 能 好 坏 会 直 


虽然 不 直接 与 HTTP 请 求 的 处 理 和 发 送 发 生 关系 ， 但 是 所 有 和 数据 有 关 的 逻辑 都 与 其 相 


程序 来 实现 的 ， 而 且 所 有 服务 端的 组 件 也 是 通过 程序 来 配合 运作 的 ， 代 码 程序 就 像 “ 胶 水 ”一 样 把 服务 端 松散 的 组 件 结合 起 来 形成 统 


性 不 言 而 喻 ， 是 瓶颈 分 析 的 重点 所 在 。 当 然 ， 可 作为 服务 端 编程 的 语言 有 很 多 种 ， 本 书 将 重点 分 析 使 节 的 内 容 。 


局 来 说 更 是 如 此 。 不 论 服务 端的 性 能 有 多 强 ， 如 果 网 络 


到 的 服务 端 组 件 也 会 不 同 ， 至 于 程序 代码 
往往 很 难 发 现 问题 的 真正 原 


因 。 


之 则 可 以 认为 是 服务 端的 问题 。 然 


绕 使 


PHP 语 言 来 实现 的 应 


服务 端 进行 详细 分 析 。 


的 开发 ， 所 以 在 第 9 章 中 ， 我 们 将 转 


B 务 端 性 能 问 


在 移动 互联 网 应 用 中 ， 客 户 端 负责 的 内 容 应 该 是 接收 服务 端 接口 返回 的 数据 ， 而 后 进行 界面 泻 染 并 展示 给 用 户 的 过 程 。 与 服务 端 不 同 的 是 ， 客 户 端 不 存在 独立 部 件 ， 所 有 应 用 的 功能 基本 都 是 在 
Android 应 用 框架 之 下 实现 的 。 所 以 ， 客 户 端 可 能 出 现 的 瓶颈 基本 都 存在 于 应 用 自身 运行 的 过 程 中 ， 下 面 我 们 就 来 分 析 客 户 端 运 行 过 程 涉及 的 重要 步骤 ， 找 出 可 能 存在 的 瓶颈 。 

1 数据 准备 

客户 端的 数据 来 源 一 般 有 两 个 ， 一 是 通过 请 求 服务 端 API 接 口 来 获取 ， 二 是 从 本 地 的 数据 存储 中 获取 。 前 者 需要 通过 网 络 传输 数据 ， 必 然 存在 一 定 的 问题 和 瓶颈 ， 在 实际 应 用 中 我 们 通常 会 采用 两 者 结合 
的 方式 来 解决 。 具 体 来 说 ， 就 是 利用 客户 端 本 地 存储 作为 缓存 ， 减 少 网 络 带 来 的 不 稳定 因素 以 及 效率 问题 。 这 点 我 们 将 在 10.1 节 中 介绍 。 另 外 ， 由 于 数据 获取 往往 需要 比较 长 的 时 间 ， 所 以 我 们 需要 使 用 异 


步 的 方式 获取 数据 ， 保 证 应 


2. 界 


m 


Ë 


主线 程 不 受 影响 ， 这 点 可 参考 10.1.2 节 中 的 内 容 。 


这 点 可 以 参考 10.3 节 中 与 Android UI 优化 相关 的 内 容 。 其 二 是 如 何 


局 方式 以 及 更 合适 的 UI 控件 来 实现 具体 的 应 用 界面 ， 


Android 客 户 端 进行 界面 泻 染 需要 考虑 两 方面 的 问题 。 其 一 是 如 何 使 用 更 好 的 布 
合理 地 使 用 外 部 资源 的 问题 ， 比 如 文字 、 图 片 等 ， 这 点 我 们 将 在 10.4 节 中 给 大 家 介绍 。 
3. 打 包 发 布 
Android 应 用 开发 完毕 之 后 ， 还 必须 经 过 必要 的 打包 和 签名 ， 而 后 才 可 以 正式 发 布 到 各 大 应 


前 面 我 们 已 经 从 Android 客 户 端 运 行 过 


到 的 。 因 此 , 应 


分 析 客 户 端 性 能 瓶颈 时 ， 首 先 需 
(Allocation Tracker) 来 跟踪 应 


内 存 使 


有 关 。 


中 的 逻辑 代码 也 是 瓶颈 分 析 的 重点 所 在 ， 与 Java 代 码 优 化 有 关 的 内 容 可 参考 10. 


平台 。 在 这 个 过 程 中 也 会 涉及 一 些 与 优化 相关 的 内 容 ， 我 们 将 在 10.4 节 中 给 大 家 做 详细 的 介绍 。 


程 的 角度 分 析 了 可 能 存在 的 性 能 瓶颈 ， 但 是 我 们 不 能 忘记 Android 应 用 框架 是 基于 Java 语 言 的 ， 在 Java 编 程 中 可 能 遇 到 的 瓶颈 在 Android 应 用 开发 中 也 是 有 可 能 遇 


175, 


83 优化 的 思路 


使 用 Eclipse 和 ADT 提 供 的 调试 工具 来 进行 问题 的 定位 (参考 7.1.3 节 ) ， 比 如 使 用 内 存 查看 器 (Heap) 查看 并 分 析 应 用 进程 的 内 存 分 配 详情 ， 或 者 使 用 分 配 跟踪 器 
运行 过 程 中 的 内 存 使 用 ， 找 到 大 致 的 方向 之 后 就 可 以 通过 单 步调 试 来 定位 问题 ,或 者 直接 写 程序 来 对 性 能 瓶颈 进行 分 析 。 根 据 实际 经 验 来 看 ,许多 客户 端的 性 能 问题 都 跟 


前 面 我 们 已 经 学 习 了 如 何 通过 系统 性 能 测试 找 出 应 用 的 性 能 瓶颈 ， 那 么 接 下 来 要 做 的 事情 就 很 清楚 了 ， 即 针对 性 能 瓶颈 制订 有 效 的 优化 方案 并 予以 实施 。 对 于 移动 互联 网 应 用 来 说 ， 优 化 工作 可 分 为 服 
务 端 和 客户 端 两 方面 ， 虽 然 这 两 方面 的 优化 思路 可 谓 大 相 径 庭 ， 但 是 基本 原则 却 是 一 样 的 。 

1. 更 快速 

优化 的 主要 目的 就 是 要 让 系统 变 得 更 有 效率 ， 简 单 地 说 就 是 变 得 更 快速 。 对 于 服务 端 来 说 ， 更 快速 就 代表 着 更 快 的 业务 处 理 速 度 和 更 高 的 处 理 量 ; 对 于 客户 端 来 说 ， 更 快速 则 意味 着 更 流畅 的 操作 性 和 
更 好 的 用 户 体验 。 从 某 种 角度 来 看 ， 运 行 效率 已 经 成 为 衡量 一 个 应 用 是 否 成 功 的 重要 标准 之 一 。 因 此 ， 更 快 自然 也 就 成 为 应 用 优化 的 首要 目的 。 

2. 更 稳定 

除了 让 系统 变 得 更 快 之 外 ， 优 化 的 另外 一 个 重要 目的 是 让 系统 运行 得 更 稳定 。 无 论 对 于 客户 端 还 是 服务 端 ， 在 追求 更 高 的 运行 效率 的 同时 还 需要 保证 系统 的 稳定 性 ， 如 果 只 求 快 而 忽略 了 稳定 性 ， 绝 对 
会 付出 惨痛 的 代价 。 因 此 ， 更 稳 也 就 成 为 应 用 优化 的 重要 目的 之 一 。 

3. 更 合理 

在 优化 方案 的 实施 过 程 中 往往 会 遇 到 功能 和 性 能 两 者 不 可 兼 得 的 情况 ， 比 如 实现 某 个 核心 功能 逻辑 的 代价 是 拖 慢 系统 的 运行 效率 ， 此 时 就 需要 根据 具体 的 情况 进行 综合 分 析 。 我 们 可 以 把 所 有 因素 列举 
出 来 ， 然 后 召集 团队 成 员 进行 深入 讨论 ， 最 终 得 到 一 个 合理 的 方案 ， 因 此 合理 性 也 是 应 用 优化 必须 要 注意 的 一 个 重要 原则 。 

理解 了 优化 的 原则 也 就 掌握 了 优化 的 基本 思路 ， 但 是 并 非 意味 着 掌握 了 应 用 优化 的 具体 思路 ， 服 务 端 和 客户 端 在 优化 思路 之 间 的 区 别 还 是 很 大 的 ， 首 先 两 者 使 用 的 编程 语言 不 同 ， 其 次 侧重 的 功能 也 不 
一 样 。 在 第 9 章 和 第 10 章 中 ， 我 们 还 将 以 微 博 应 用 为 例 ， 分 别 对 微 博 服 务 端 和 微 博客 户 端的 优化 方法 进行 介绍 ， 让 大 家 理 清 移动 互联 网 应 用 系统 的 优化 思路 。 
84 小 结 

本 章 主要 介绍 了 与 软件 性 能 分 析 相 关 的 知识 。 首 先 ， 介 绍 了 主流 的 服务 端 性 能 测试 工具 以 及 客户 端 性 能 测试 脚本 的 写法 。 然 后 ， 分 析 了 可 能 存在 的 性 能 瓶 瑞 ， 并 从 服务 端 和 客户 端 两 方面 前 述 了 可 行 的 
优化 思路 。 这 些 知识 都 是 从 实际 项 目的 经 验 中 提取 出 来 的 ， 具 有 很 高 的 实用 价值 ， 相 信 对 大 家 的 学 习 和 工作 都 会 有 帮助 。 另 外 ， 本 章 内 容 也 是 后 两 章 内 容 的 引子 ， 在 第 9 章 和 第 10 章 中 ， 我 们 将 分 别 介绍 服 
务 端 和 客户 端 优化 的 相关 内 容 。 
第 9 章 ”服务 端 优 化 

对 于 移动 互联 网 应 用 来 说 ， 服 务 端的 功能 主要 是 提供 与 业务 逻辑 相关 的 接口 ， 供 客户 端 调 用 并 返回 数据 。 通 过 之 前 对 服务 端 性 能 瓶颈 的 分 析 ， 我 们 了 解 到 服务 端的 优化 主要 包括 服务 器 优化 、 数 据 库 优 


化 、 代 码 程序 优化 以 及 网 


9.1 


络 传输 优化 几 个 部 分 ， 而 其 中 的 重 中 之 寻 


就 是 对 代码 程序 的 优化 ， 首 先 介绍 优化 PHP 系 统 的 方法 。 


优化 PHP 程 序 
优化 PHP 程 序 是 服务 端 优化 的 核心 。 一 方面 ， 本 书 所 讲 的 应 用 服务 端的 所 有 逻辑 都 是 使 用 PHP 代 码 实 现 的; 另 一 方面 ， 所 有 的 服务 端 组 件 也 都 需要 与 PHP 程 序 结合 起 来 才能 良好 地 运转 ， 为 应 用 客户 端 
提供 服务 。 从 某 种 意义 上 说 ， 优 化 PHP 程 序 也 就 是 对 服务 端 处 理 逻 辑 的 优化 。PHP 程 序 优化 的 内 容 比 较 多 ， 下 面 重点 介绍 PHP 代 码 优 化 、Session 机 制 优化 、 使 用 缓存 中 间 件 以 及 使 用 APC 加 速 几 个 部 分 。 


9.1.1 优化 PHP 代 码 

既然 我 们 选择 使 用 PHP 语 言 来 进行 服务 端 逻 辑 编 程 ， 那 么 就 必须 要 先 懂 得 如 何 正确 而 高 效 地 使 用 这 门 语言 。 虽 然 前 面 我 们 已 经 学 习 了 许多 使 用 PHP 进 行 编程 的 方法 ， 大 家 应 该 对 如 何 使 用 PHP 语 言 来 进 
行 服务 端 开 发 有 了 一 定 的 了 解 ， 但 是 这 并 不 代表 我 们 已 经 真正 掌握 了 这 门 语言 。 每 一 门 编程 语言 都 有 各 自 的 特点 ， 同 时 也 有 各 自 不 同 的 编程 技巧 ，PHP 当 然 也 不 例外 ; 只 有 掌握 了 PHP 的 编程 技巧 之 后 ， 才 
能 算是 基本 掌握 了 这 门 编程 语言 。 


当然 ， 也 只 有 在 掌握 足够 多 的 编程 技巧 之 
量 并 找 出 需要 优化 的 点 ， 这 个 过 程 也 叫 作 Code Review， 也 算是 代码 优化 中 的 


后 ， 我 们 才 有 可 能 对 PHP 代 码 


1. 升 级 到 最 新 PHP 版 本 


要 知道 ， 编 程 语言 本 身 也 是 不 断 发 


获取 到 所 需 信息 。 


展 的 ， 新 版 的 语言 包 通常 


进行 优化 。 在 实际 项 目 中 ， 当 服务 端 编码 工作 完成 之 后 ， 我 们 通常 会 让 一 些 比较 资深 的 程序 员 来 对 代码 进行 审查 ， 评 估 程 序 的 质 
要 一 环 。 下 面 我 们 就 来 介绍 一 些 比较 常见 的 PHP 编 程 技 巧 ， 以 及 Code Review 过 程 中 可 能 涉及 的 一 些 优化 原则 。 


因此 作为 专业 人 1 


上 ， 我 们 需要 定期 关注 新 版 本 的 出 现 ， 对 于 PHP 来 说 ， 我 们 可 以 从 官网 php.net 上 


自身 的 漏洞 修补 和 性 能 优化 。 


2. 减 少 include 和 require 


include 和 require 常 用 于 包含 常用 的 PHP 类 库 代 码 ， 不 过 需要 知道 的 是 这 两 个 方法 都 包含 了 文件 读 取 的 逻辑 ， 虽 然 PHP 本 身 已 经 对 这 个 过 程 做 过 一 定 的 优化 ， 但 是 在 大 量 使 用 的 情况 下 有 可 能 会 造成 性 
能 的 下 降 。 我 曾经 对 一 些 比较 大 型 的 类 库 进 行 过 测试 ， 类 库 包 含 逻 辑 占用 的 运行 时 间 甚 至 超过 总 运行 时 间 的 50%。 这 个 问题 可 以 采用 安装 APC 加 速 器 组 件 的 方法 来 缓解 ， 这 点 我 们 将 在 9.1.4 节 中 介绍 。 


3. 用 局 部 变量 代替 全 局 变量 


局 部 变量 的 速度 是 最 快 的， 特别 在 一 些 循环 逻辑 中 ， 我 们 要 尽 可 能 使 用 局 部 变量 来 进行 运算 。 至 于 为 什么 不 用 全 局 变量 ， 一 方面 是 因为 运行 效率 的 原因 ， 另 一 方面 则 是 考虑 到 全 局 变量 不 易于 管理 。 


4 .尽量 使 用 静态 函数 或 方法 


如 果 有 可 能 我 们 应 该 尽量 把 函数 或 者 方法 定义 成 静态 的 ， 即 加 上 static 标 记 ， 因 为 这 样 有 可 能 会 让 程序 的 执行 速度 提升 好 几 倍 。 


5. 释 放 那 些 不 用 的 变量 或 者 资源 


不 要 过 分 依赖 PHP 的 内 存 回 收 机 制 ， 程 序 中 一 些 用 不 到 的 变量 或 者 资源 应 该 及 时 地 释放 ， 我 们 可 以 通过 unset 方 法 ， 或 者 直接 将 其 设置 为 null。 另 外 ， 如 果 遇 到 与 其 他 组 件 相关 的 资源 更 要 特别 注意 ， 比 
如 数据 库 连 接 等 。 


6 .使 用 单 引号 代替 双 引 号 来 包含 字符 串 


在 PHP 中 ,字符 串 通常 使 用 单 引号 来 包含 ， 因 为 使 用 双 引 号 可 能 会 额外 产生 字符 转 义 甚至 变量 解析 的 逻辑 ， 单 引号 的 执行 效率 要 比 双 引 号 高 。 


7. 使 用 @ 屏 蔽 错误 会 降低 脚本 运行 速度 


为 了 使 用 方便 ， 某 些 程序 员 喜 欢 使 用 @ 号 来 屏蔽 报错 信息 ， 但 是 需要 注意 的 是 这 种 做 法 会 降低 脚本 的 运行 速度 ， 不 推荐 使 用 。 


8. 不 要 过 度 使 用 PHP 的 OOP 


为 了 能 更 好 地 管理 代码 ， 现 在 比较 大 型 的 PHP 程 序 都 更 倾向 使 用 面向 对 象 思路 (OOP) 来 构建 程序 框架 ， 但 是 由 于 对 象 通常 比较 占 内 存 ， 类 库 太 多 还 有 可 能 产生 大 量 的 include 和 require 操 作 ， 从 而 造 
成 额外 的 系统 开销 。 因 此 ， 我 们 要 根据 实际 情况 合理 地 使 用 DOP 思想， 切 不 可 言 目 使 用 、 过 度 使 用 。 不 过 ， 这 个 问题 同样 可 以 使 用 APC 加 速 器 组 件 来 缓解 。 


9. 使 用 抽象 类 代替 接 


在 PHP 中 使 用 接口 (interface) 的 成 本 非常 高 ， 编 程 时 应 该 尽量 避免 使 用 。 类 似 的 逻辑 封装 我 们 通常 可 以 使 用 抽象 类 (abstract class) RRE, 


10. 使 用 正则 表达 式 代价 昂贵 


虽然 PHP 语 言 的 正则 表达 式 功能 非常 强大 ， 但 是 我 们 需要 知道 它 的 执行 成 本 同样 高 晶 ， 在 可 能 的 情况 下 ， 应 该 尽量 使 用 PHP 的 字符 串 处 理 函 数 来 代 蔡 。 


11. 尽 可 能 地 压缩 需要 存储 的 数据 


任何 数据 存储 都 需要 占用 系统 的 空间 资源 ， 所 以 在 可 能 的 范围 内 应 该 尽量 对 数据 进行 压缩 ， 从 而 节省 系统 的 空间 资源 。 比 如 ， 我 们 保存 IP 地 址 时 可 以 先 使 用 ip2long 函 数 把 IP 地 址 转化 成 整 型 数据 来 存 
储 ， 然 后 再 通过 long2ip 函 数 还 原 。 另 外 ， 对 于 一 些 大 数据 还 可 以 使 用 gzcompress 和 gzuncompress 进 行 压缩 和 解压 。 


12. 使 用 更 高 效 的 语句 


PHP 编 程 语句 的 效率 也 有 高 低 之 分 ， 下 面 我 们 将 对 其 中 比较 重要 的 语句 进行 对 比 ， 以 后 大 家 在 写 代码 时 需要 注意 。 


“分支 语句 中 switch…case 的 效率 高 于 if…elseif*…else。 


+ 循环 语句 中 foreach 效 率 最 高 ，for 其 次 ，while 最 低 。 


+ 有 加 语句 中 ++ 畦 的 写法 快 于 $++。 


13. 使 用 更 高 效 的 函数 


PHP 的 函数 库 非 常 丰富 ， 相 同 的 功能 也 可 以 使 用 不 同 的 函数 来 完成 。 不 过 ， 不 同 函数 的 运行 效率 也 是 不 同 的 ， 我 们 在 使 用 时 需要 注意 ， 下 面 我 们 对 一 些 常用 函数 进行 对 比 。 


“ 字符 打印 函数 echo 快 于 print。 
+ 字符 替换 函数 strtr 的 效率 最 高 ，str_replace 其 次 ，preg_replace 正 则 替换 最 低 。 


: 数组 查询 函数 array_key_exists 最 快 ，isset 其 次 ，in_array 最 低 。 


虽然 对 于 某 些 逻辑 不 是 很 复杂 的 程序 来 说 ， 也 许 每 次 代码 优化 的 效果 并 不 是 非常 明显 ， 但 是 养 成 一 个 良好 的 编程 习惯 是 非常 重要 的 ， 这 也 是 高 级 程序 员 和 普通 程序 员 之 间 的 差别 。 当 然 ， 上 面 提 到 的 并 


非 所 有 的 PHP 编 程 技巧 ， 况 且 要 真正 掌握 这 些 技巧 也 不 是 一 朝 一 夕 所 能 完成 的 ， 所 谓 学 海 无 涯 ， 只 有 在 学 习 和 动手 的 过 程 中 不 断 总 结 积累 ， 才 能 让 自己 的 编程 功力 更 上 一 层 楼 。 


当然 ， 除 了 上 述 列举 的 通用 的 优化 方法 ， 还 有 许多 优化 方案 需要 和 具体 的 代码 逻辑 相 结合 才能 生效 ， 比 如 6.4.3 节 中 介绍 微 博 列表 接口 时 ， 曾 经 介绍 到 获取 指定 用 户 微 博 列表 的 逻辑 ， 也 就 是 DAO 类 
Core_Blog 中 getListByCustomer 方 法 的 逻辑 ， 如 代码 清单 6-33 所 示 。 此 方法 的 代码 逻辑 中 留 下 了 一 个 需要 优化 的 地 方 ， 就 是 在 循环 获取 微 博 列表 时 每 次 都 要 去 数据 库 获取 用 户 信息 。 当 然 ， 在 微 博 列表 或 
者 评论 列表 中 这 么 做 是 没有 问题 的 ， 但 是 这 里 获取 的 是 指定 用 户 的 微 博 列表 ， 那 么 所 有 用 户 的 信息 应 该 都 一 样 ， 完 全 没有 必要 重复 获取 用 户 信息 。 因 此 ， 我 们 可 以 对 代码 做 出 以 下 修改 ， 如 代码 清单 9-1 所 


示 。 


代码 清单 9-1 


class Core Blog extends Demos Dao Core 


{ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public function getListByCustomer ($customerId, $pageld = 0) 7 
{ 
$list = array(); 
$sql = $this-»select () 
-»from($this-»tl, '*') 
->where ("{$this->t1}.customerid = ?", $customerId) 
->order ("{$this->t1}.uptime desc") 
-»limitPage (SpageId, 10); 
$res = $this-»dbr()-»fetchAll ($sql); 
if ($res) { 
ScustomerDao = new Core Customer () ; 


// 用 户 信 息 只 需要 获取 一 次 


省 


Scustomer = $customerDao-»read ($customerId); 
foreach ($res as $row) { 
// 注释 重复 获取 用 户 信息 的 逻辑 
//$customer = $customerDao->read ($row['customerid']); 
$blog = array( 
'id' => Srow['id'], 


"content! => '<b>'.Scustomer['name'].'</b> : '.Srow['content'], 
"comment! => 'Gfit ('.Srow['commentcount'].')', 
‘uptime! => Srow['uptime'], 


); 
array_push ($list, $blog); 
} 


return $list; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


从 上 述 代码 中 可 以 看 出 ， 我 们 把 foreach 循 环 中 获取 用 户 信息 的 逻辑 注释 掉 ， 并 提取 到 循环 逻辑 的 外 面 ， 这 样 程 序 逻 辑 只 需要 获取 一 次 当前 用 户 的 信息 即 可 。 大 家 可 以 想象 一 下 ， 这 个 小 小 的 修改 可 以 节 
多 少 次 数据 查询 ， 提 升 多 少 运行 效率 。 


总 之 ， 优 化 PHP 代 码 时 ， 既 要 考虑 常见 的 优化 技巧 ， 还 要 根据 具体 的 逻辑 来 分 析 。 当 遇 到 耗 时 操作 ， 比 如 复杂 计算 、 数 据 库 查询 等 ， 或 者 碰 上 循环 、 递 归 逻 辑 时 ， 要 特别 注意 ， 因 为 这 些 位 置 最 可 能 


现 性 能 瓶颈 ， 也 最 需要 进行 代码 优化 。 


9. 


博 


12 ”优化 session 机 制 


Session 会 话 的 基础 概念 和 用 法 都 已 经 在 3.1.4 节 中 介绍 过 了 ， 我 们 了 解 到 Session 会 话 是 PHP 服 务 端的 重要 组 成 部 分 。 然 后 通过 6.2.1 节 中 对 用 户 登 录 接 口 罗 辑 的 介绍 ， 我 们 对 Session 会 话 的 使 用 有 了 进 
步 的 认识 ， 这 让 我 们 更 加 清楚 地 了 解 到 它 在 服务 端 系统 中 的 重要 作用 。 简 单 来 阅 ，Session 就 像 每 个 用 户 自 带 的 全 局 变量 ， 用 于 保存 用 户 在 服务 端 需要 保存 的 任何 信息 。 


要 进行 Session 优 化 ， 首 先 必须 了 解 在 PHP 环 境 中 如 何 配置 Session 会 话 。 实 际 上 ，Session 会 话 的 功能 都 可 以 在 系统 配置 文件 php.ini 中 设置 ， 当 然 我 们 也 可 以 使 用 ini_set 函 数 从 程序 上 进行 设置 。 在 微 
应 用 的 服务 端 程序 框架 中 ， 我 们 可 以 在 etc/ 目 录 下 找到 与 Session 会 话 有 关 的 配置 文件 global.session.php， 配 置 范例 如 代码 清单 9-2 所 示 。 


小 贴 士 : PHP 提 供 了 ini_set 和 ini_get 函 数 ， 用 于 快速 设置 和 获取 系统 配置 文件 php.ini 的 配置 项 值 。 


代码 清单 9-2 


ini set('session.name', 'sid'); // Session 名 称 
'session.auto start', 0); // 不 支持 自动 启用 


( 
( 
( 
( 
( 
ini set('session.referer check', ''); 
( 
( 
( 
( 
( 


ini set('session.gc maxlifetime', 3600); // Session 有 效 期 

ini set('session.use cookies', 0); // 不 使 用 Cookies 

ini set('session.use only cookies', 0); 

ini set('session.use trans sid', 1); // 使 用 URL 地 址 传递 Session ID 

ini set('session.hash function', 1); // 计算 Session ID 的 散 列 算法 (0: MD5, 1: SHA-1) 


从 上 述 配置 范例 中 ， 我 们 可 以 看 到 最 常用 的 PHP Session 设 置 ， 这 里 需要 注意 以 下 几 点 。 首 先 ， 一 般 不 建议 启用 auto_start， 因 为 创建 session 需要 消耗 系统 资源 ， 我 们 通常 只 会 在 需要 用 到 Session 时 ， 


才 会 使 用 session_start 函 数 来 开启 Session 功 能 。 其 次 ，Session 的 有 效 期 需要 根据 系统 的 具体 情况 而 定 。 如 果 有 效 期 太 长 ， 有 可 能 导致 由 于 会 话 数据 过 多 而 造成 的 负载 问题 ;而 假如 有 效 期 太 短 ， 也 有 可 能 


出 


现 由 于 会 话 创建 过 于 频繁 而 出 现 的 性 能 问题 。 系 统 默 认 的 有 效 时 间 是 1440 秒 ， 也 就 是 24 分 钟 ， 在 实际 项 目 中 我 们 通常 会 将 这 个 时 间 设 置 在 1 到 8 小 时 之 间 。 由 于 移动 互联 网 应 用 的 客户 端 不 是 浏览 器 ， 所 以 


我 们 通常 不 会 使 用 Cookies 来 存储 Session ID， 而 是 通过 URL 地 址 参数 直接 传递 。 最 后 ，PHP 中 用 于 计算 Session 1D 的 算法 还 是 比较 成 熟 的， 综合 使 用 了 时 间 戳 、 随 机 数 等 随机 因子 并 采用 了 MD5 和 SHA-1 


的 散 列 算法 来 保证 Session ID 的 唯一 性 。 


此 外 还 需要 注意 的 是 ，PHP Session 使 用 的 默认 存储 方式 是 文件 存储 ， 在 php.ini 中 我 们 可 以 通过 session.save_handler 选 项 来 选择 需要 的 存储 方式 ， 但 是 使 用 文件 存储 方式 的 效率 比较 低 ， 也 不 利于 系 


统 架 构 的 扩展 ， 在 实际 项 目 中 经 常 通过 session_set_save_handler 方 法 来 设置 Session 回 调 接 口 ， 用 于 控制 Session 会 话 的 存储 逻辑 ， 示 例 请 参考 代码 清单 3-12。 另 外 ， 常 见 的 存储 介质 有 数据 库 、 高 速 缓存 
服务 等 。 


理解 了 上 述 内 容 ， 下 面 我 们 来 分 析 PHP Session 的 优化 思路 。 首 先 ， 每 次 创建 Session 时 ， 都 会 产生 资源 消耗 ， 所 以 我 们 要 把 需要 使 用 Session 的 接口 和 不 需要 使 用 Session 的 接口 分 清楚 ， 干 万 不 要 想 当 


然 地 在 全 局 配置 文件 中 使 用 session_start 方 法 。 其 次 ， 每 次 会 话 请 求 时 都 需要 确保 带 上 Session ID， 因 为 如 果 服 务 端 获取 不 到 Session ID 的话 ， 将 会 重新 创建 一 个 ， 这 样 会 产生 很 多 无 用 的 垃圾 Session， 当 
然 我们 也 可 以 在 Session 回调 接口 的 write 方法 中 写 程序 逻辑 来 避免 这 个 问题 。 另 外 ， 在 选择 存储 方式 时 尽量 使 用 快速 的 存储 介质 ， 比 如 高 速 的 缓存 服务 器 Memcache、Redis 等 ， 下 面 用 Memcache 缓 存 服 
务 作为 存储 方式 的 Session 回 调 接口 的 实现 供 大 家 参考 ， 如 代码 清单 9-3 所 示 。 


代码 清单 ”9-3 


<?php 
class MemcacheSession { 
private static Smemcache = null; 
private static $lifetime = null; 
// 初始 化 逻辑 
public static function start ($memcache, $expire = 3600) { 
self::$memcache = $memcache; 
self::$lifetime = $expire ? $expire : ini get('session.gc maxlifetime'); 
session set save handler( ~ ~ 


array( CLASS , "open"), 
array( CLASS , "close"), 
array( CLASS , "read"), 
array( CLASS , "write"), 
array( CLASS , "destroy"), 
array( CLASS , "gc") 


); 


session start( 


} 
public static function open ($path, $name) { 
return true; 


Public static function close() { 
return true; 


š 

// 读 取 Session 逻辑 

public static function read($id) { 
Sout-self::$memcache-»get ($id) ; 
if (!$out) return ''; 
return Sout; 


l 
// 存储 Session 逻辑 
public static function write($id, $data) ( 
$method = $data ? 'set' : 'replace'; 
return self::$memcache-»$method($id, $data, MEMCACHE COMPRESSED, self::$lifetime) ; 


} 

// 销毁 Session 逻辑 

public static function destroy($id) ( 
return self: :$memcache->delete ($id); 

} 

public static function gc($lifetime) { 


return true; 


) 
} 
// 使 用 范例 


$memcache = new Memcache; 
$memcache->connect ("127.0.0.1", 11211) or die("connection failed"); 
MemcacheSession: : start ($memcache) ; 


在 微 博 服务 端 实例 的 代码 中 ， 并 没有 包含 Session 优 化 这 部 分 的 使 用 范例 ， 不 过 大 家 完全 可 以 尝试 按照 前 面 的 优化 思路 和 示例 代码 来 自己 实现 一 下 。 
9.1.3 ”使 用 缓存 中 间 件 


随 着 互联 网 的 发 展 ， 完 全 依赖 数据 库 的 服务 端 架 构 已 经 无 法 满足 我 们 的 需求 了 ， 与 日 俱 增 的 查询 和 写 入 请 求 会 把 数据 库 压 垮 ， 因 此 我 们 必须 想 办 法 为 数据 库 减 压 。 经 过 分 析 之 后 ， 我 们 发 现 数据 库 的 压 
力 来 源 于 两 方面 ， 即 查询 和 写 入 。 


对 于 大 部 分 的 网 络 应 用 来 说 ， 查 询 请 求 要 比 写 入 请 求 多 出 许多 。 就 拿 微 博 应 用 来 说 ， 大 部 分 的 用 户 还 是 来 看 微 博 的 ， 写 微 博 的 相对 较 少 ， 所 以 我 们 要 优先 考虑 如 何 解决 因为 过 多 的 查询 带 来 的 压力 。 一 
个 比较 常见 的 思维 就 是 分 散 请 求 ， 即 准备 多 台数 据 库 来 同时 提供 服务 ， 但 是 如 果 还 是 挡 不 住 该 怎么 办 ? 这 时 缓存 中 间 件 就 出 现 了 ， 其 原理 就 是 把 查询 到 的 信息 缓存 在 服务 器 内 存 中 ， 来 替代 数据 库 处 理 大 部 
分 的 查询 请 求 。 由 于 在 内 存 中 进行 存 取 操作 的 速度 肯定 比 在 文件 中 快 得 多 ， 另 外 获取 缓存 数据 都 不 需要 复杂 的 查询 逻辑 ， 所 以 从 缓存 中 查询 的 效率 要 比 直 接 从 数据 库 中 查询 快 得 多 。 图 9- 1 为 缓存 优化 策略 的 


示意 图 。 


图 9-1 缓存 优化 策略 示意 图 


从 图 9-1 中 可 以 看 出 ， 缓 存 中 间 件 主要 负责 读 取 的 过 程 ， 每 个 缓存 数据 通常 都 会 有 唯一 的 字符 串 标 识 ， 程 序 通过 这 个 标识 来 获取 缓存 数据 ， 如 果 数 据 不 存在 则 从 数据 库 查 询 并 保存 该 缓存 数据 ， 那 么 下 次 
程序 就 可 以 从 缓存 中 直接 获取 到 这 个 数据 。 当 然 ， 我 们 还 需要 知道 每 个 缓存 都 有 过 期 时 间 ， 在 这 个 时 间 之 内 缓存 数据 才 是 有 效 的， 我 们 需要 根据 实际 需求 和 访问 量 来 综合 考虑 过 期 时 间 的 长 短 。 


目前 业内 比较 常用 的 缓存 中 间 件 为 Memcache 和 Redis， 下 面 我 们 将 对 它们 进行 简单 的 介绍 和 对 比 。 


1.Memcache 


Memcache 是 缓存 中 间 件 中 的 里 程 碑 ， 该 产品 最 初 设计 用 于 为 Live Journal 站 点 提供 服务 ， 现 在 已 经 被 用 在 很 多 著名 的 网 站 应 用 中 了 ， 比 如 Facebook、Mixi、Vox 等 。Memcache 把 数据 存储 在 服务 器 
内 存 中 的 一 个 大 型 散 列 结构 里 ， 使 用 了 Libevent 异 步 事件 处 理 库 ， 可 以 快速 地 响应 客户 端的 请 求 ， 返 回 对 应 的 缓存 数据 。 另 外 ，Memcache 还 支持 分 布 式 扩展 ， 即 使 用 多 台 缓 存 中 间 件 服务 器 来 同时 服务 ， 
进一步 提高 缓存 系统 的 处 理 能 力 。 


小 贴 士 : Libevent 是 一 个 异步 事件 处 理 库 ， 轻 量 级 ， 专 注 于 网 络 ， 具 有 不 错 的 性 能 ， 支 持 Windows、Linux、BSD 等 多 种 平台 ， 支 持 select、poll、epoll、kqueue 等 I/O 多 路 复 用 技术 ， 目 前 被 广泛 应 用 于 各 种 
网 络 中 间 件 中 ， 如 Memcache、Vomit、Nylon 等 。 


PHP 语 言 内 置 了 Memcache 客 户 端 类 库 ， 使 用 起 来 非常 方便 ， 代 码 清单 9-4 为 常见 缓存 获取 和 设置 逻辑 的 使 用 示例 。 


代码 清单 9-4 


$memcache = new Memcache; 


// 添加 多 个 缓存 中 间 件 服务 器 


$memcache->addServer ('memcache hostl', 11211); 
$memcache-»addServer ('memcache host2', 11211); 
// 获取 cache var Key 对 应 的 缓存 数据 

$cacheVar = $memcache->get ('cache var key'); 


// 获取 缓存 数据 失败 的 逻辑 
if (!$foo) { 


// 从 数据 库 查询 数据 保存 到 $queryVar 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
// 把 查询 数据 保存 到 缓存 中 

Smemcache->set ('cache var key', $queryVar); 

$cacheVar = $queryVar; ` 


2.Redis 


Redis 是 缓存 中 间 件 中 的 新 贵 ，: 


push、pop、add、remove 等 更 加 丰富 的 原子 性 操作 。 另 外 ，Redis 没 有 使 有 


Memcache。 


可 能 由 于 Redis 产 品 还 比较 新 ，PHP 和 暂时 没有 提供 官方 的 客户 端 类 库 ， 目 前 相对 比较 稳定 


(1) php-redis 库 


此 类 库 完全 使 用 PHP 语 言 实现 ， 包 含 了 Redis 数 据 的 基本 操作 ， 但 是 个 人 认为 有 些 功能 


(2) phpredis 扩 展 


PHP 语 言 的 扩展 实现 ， 需 要 安装 ， 不 过 功能 相对 比较 全 ， 还 包括 了 Session Handler 的 实现 ， 推 荐 大 家 使 用 。 


述 了 。 


总 之 , 使 
数据 写 入 到 Redis 缓 存 中 ， 然 后 再 转 存 到 数据 库 中 去 。 其 实 ， 我 们 可 以 把 缓存 和 队列 的 使 


另外 ， 在 微 博 实例 的 服务 端 框架 Hush Frameworl 


使 用 。 


本 功能 和 Memcache 类 似 ， 但 是 支持 存储 的 数据 结构 更 多 ， 包 括 字符 


缓存 中 间 件 是 PHP 服 务 端 优 化 中 非常 


B (string) 、 链 表 (list) 、 


的 客户 端 类 库 有 以 下 两 个 。 


实现 得 不 够 完整 ， 更 多 信息 请 参考 官方 网 站 http://code.google.com/p/php-redis/。 


A (set) MAFRA (zset) ， 而 且 这 些 数据 类 型 都 支持 
件 处 理 机 制 ， 不 过 根据 在 实际 项 目 中 的 性 能 测试 结果 来 看 ，Redis 的 性 能 远 远 超过 


MA, REM 


官方 网 站 https://github.comynicolasff/phpredis 上 有 比较 详细 的 使 


效果 ， 缓 存 中 间 件 通 


要 的 一 个 步骤 ， 根 据 实际 项 目 中 的 


9.1.4 使 用 APC 加 速 


随 着 网 络 应 用 的 不 断 发 展 ， 罗 辑 代 码 也 


实例 的 最 底 


存 来 加 速 代 码 的 执行 。 


APC (Altern 
极 大 地 提高 PHP 的 


1) 从 http://pecl.php.net/package/apc 下 载 最 新 版 本 。 


2) 解压 并 进入 APC 源 码 目录 。 


3) 使 


4) 在 php.in 瑟 置 文件 中 打开 APC 模 块 ， 即 加 入 配置 extension=apc.so。 
5) 重启 HTTP 服 务 器 即 可 。 


兴趣 可 以 对 比 一 下 使 
系统 的 实时 状态 了 ， 监 控 界 面 如 图 


phpize 安 装 为 PHP 扩 


恋 得 
变 得 


慨 类 库 就 是 Zend Framework, 


虽然 我 们 已 经 在 Hush Framework 中 做 了 一 定 的 优化 ， 但 是 引入 庞大 类 库 代码 的 资源 消耗 还 是 比较 高 ， 


ative PHP Cache，PHP 代 码 缓存 系统 ) 是 非常 好 的 PHP 缓 存 解决 方案 ， 通 过 缓存 和 优化 PHP 中 间 码 (opcode) 来 提高 PHP 的 执行 效率 。 根 据 实际 项 
执行 效率 。 此 外 APC 还 提供 了 一 系列 接口 


展 (apc.so) 。 


看 做 是 对 整个 服务 端 MO 系 统 的 优化 。 


体 逻 辑 实 现 可 以 参考 Hush_Cache 类 ; 虽然 在 微 博 实例 中 没有 使 
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中 也 已 经 整合 了 对 各 种 缓存 的 使 


到 一 些 比较 大 型 的 类 库 时 ， 比 如 Zend Framework, 382.324 5:82 8.8 


越 来 越 复杂 ， 特 别 是 当 我 们 需 


极 大 地 提高 服务 端的 查询 速度 。 另 外 ，Redis 缓 存 还 可 以 作为 写 入 队列 来 使 用 ， 即 先 把 


到 ， 但 是 还 是 建议 大 家 根据 类 库 文档 来 尝试 


考虑 一 下 程序 的 执行 效率 了 。 实 际 上 ， 本 书 微 博 应 


上 线 时 ， 我 们 还 需要 使 


一 些 代码 级 别 的 组 


该 缓存 系统 。APC 的 安装 过 程 比较 简 自 


方法 来 帮助 我 们 控制 和 使 


APC 前 


后 的 程序 执行 速度 ， 相 信 结 果 会 让 你 相当 


状态 ， 我 们 可 以 把 安装 包 内 的 apc.php 脚 本 放 到 站 点 


效果 来 看 ，APC 确 实 能 


录 下 。 打 开 对 应 的 网 址 就 可 以 看 到 APC 


Refresh Data [View nost stats | System Cache Entries User Cache Entries Version Check 


General Cache Information Host Status Diagrams 
APC Version 312 Memory Usage 


(Multiple slices indieste fragments) 
PHP Version 53.5 
APC Host localhost 
Sener Software nginx/0 8 49 


Shared Memory 1 Segment(s) with 128.0 MBytes 
(mmap memory. pthread mutex locking) 


Start Time 2012/02/22 17:00:35 
Uptime 15 weeks, 4 days, 21 hours and 34 minutes 
File Upload Support 1 


File Cache Information 
Cached Files 1591 (110.0 MBytes) 
Hits 298414245 


B Free: 17.4 MBytes (13 6%) [E] Hits: 298414245 (100.0%) 


Mi 12454 lll] Used: 110.6 MBytes (86.4%) Il] Misses: 12454 (0.0%) 
isses D 


Request Rate (hits, misses) 31.43 cache requəsts/səcond Detailed Memory Usage and Fragmentation 
Hit Rate 31 43 cache requests/second 

Miss Rate 0.00 cache requests/second 

Insert Rate 0.00 cache requests/second Bet page 

Cache full count 1 re ese 


图 9-2 APC 监 控 界 面 


监控 页 面 左边 是 APC 缓 存 系统 的 全 局 信息 、 缓 存 状态 和 运行 时 (Runtime) 的 配置 信息 ， 右 边 则 是 实时 的 系统 内 存 占用 和 缓存 命中 率 等 信息 。 另 外 ， 我 们 还 可 以 在 php.ini 中 调整 APC 系 统 的 配置 参数 ， 
我 们 将 挑选 其 中 比较 重要 的 配置 参数 简介 如 下 。 


“apc.enabled: APC 缓 存 开关 ， 若 设 成 0 则 表示 禁用 APC。 

: apc.shm segments: 为 APC 分 配 共享 内 存 块 的 数量 ， 如 果 APC 已 经 用 完 所 有 的 物理 内 存 ， 可 以 尝试 着 提高 这 个 参数 值 。 

- apc.shm size: 每 个 共享 内 存 块 的 大 小 ， 以 MB 为 单位 ， 默 认 值 是 32。 我 们 需要 根据 项 目 代码 量 来 设置 ， 通 常会 设 为 128 或 者 256。 

-apc.ttl: 缓存 的 失效 时 间 ， 为 了 让 运行 效率 最 大 化 ， 我 们 通常 会 把 该 参数 值 设 置 为 0， 让 缓存 永久 有 效 ， 不 过 要 注意 的 是 为 了 避免 可 能 出 现 的 问题 更 新 代码 之 后 需要 重启 服务 器 。 
-apc.gc ttl: 缓存 垃圾 回收 器 的 过 期 时 间 ， 默 认 是 3600 秒 。 

- apc.enable-cli: 是 否 为 命令 行 模式 (CLI) 的 PHP 脚 本 设置 缓存 ， 一 般 在 调试 时 使 用 ， 默 认 值 为 0。 

: apc.max file size: 文件 的 大 小 限制 ， 默 认 是 1MB， 遇 到 特殊 文件 时 可 能 会 用 到 。 


总 之 ，APC 缓 存 已 经 是 PHP 服 务 端的 标准 配置 ， 甚 至 有 可 能 被 集成 到 下 一 版 的 PHP 语 言 中 去 。 结 合 之 前 介绍 的 PHP 代 码 的 优化 、Session 机 制 的 优化 以 及 缓存 中 间 件 的 使 用 ， 我 们 从 多 个 角度 介绍 了 PHP 
服务 端的 优化 技巧 ， 这 是 服务 端 优化 的 重要 步骤 。 


92 ”优化 数据 传输 


对 于 移动 互联 网 应 用 来 说 ， 需 要 通过 网 络 在 服务 端 和 客户 端 之 间 传 输 数据 。 因 此 ， 如 果 数 据 传输 过 程 不 通畅 ， 必 然 会 影响 到 整个 系统 的 运行 效率 。 如 果 是 这 样 ， 就 算 服务 端的 运行 速度 再 快 ， 用 户 也 会 
觉得 应 用 响应 很 慢 ， 所 以 数据 传输 过 程 的 优化 也 是 服务 端 优化 中 非常 重要 的 一 环 。 


9.2.1 优化 JSON 协 议 


我 们 知道 ， 在 通信 协议 的 通用 设计 原则 中 ， 通 用 性 和 简洁 性 是 最 重要 的 ， 关 于 这 两 点 的 详细 解释 请 参考 4.6 节 。 简 洁 性 就 不 多 说 了 ，JSON 协 议 的 结构 和 语法 都 要 比 其 他 文本 协议 简洁 很 多 ， 所 以 选择 
JSON 协 议 作为 微 博 应 用 通信 协议 的 基础 本 身 就 是 对 系统 的 一 种 优化 。 另 外 ， 在 设计 JSON 消 息 时 注意 保证 消息 字段 名 简短 、 清 晰 ， 下 面 我 们 主要 介绍 如 何 保证 协议 的 通用 性 。 


通过 第 6 章 对 服务 端 API 接 口 逻 辑 代码 的 分 析 ， 我 们 知道 在 所 有 服务 端 接口 的 逻辑 中 ， 都 会 调用 render 方 法 来 打印 结果 的 JSON 数 据 ， 而 此 方法 就 是 对 协议 通用 性 的 一 个 保证 ， 使 用 统一 的 方法 处 理 消息 
有 利于 对 JSON 数 据 的 控制 ， 接 下 来 我 们 观察 此 方法 的 代码 实现 ， 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 


class Demos_App Server extends Hush Service 


http://www.hzcourse. com/ resource/readBook?path-/openresources/teach « ebook/uncompressed/15327/OEBPS/Text/.. 
public function render ($code, $message, $result = '') 
{ 
// 处 理 result 数 据 
if (is array($result)) { 
foreach ((array) $result as $name => $data) { 
// 处 理 对 象 数组 
if (strpos($name, '.list')) { 
$model = trim(str replace('.list', '', $name)); 
foreach ((array) $data as $k => $v) ( 
$result [$name] [$k] = M($model, $v); 


} 
// 处 理 单个 对 象 
) else ( 
$model = trim($name) ; 
$result [$name] = M($model, $data); 


] 
} 


} 
// 打印 JSON 数 据 
echo json encode (array ( 
'code' => $code, 
=> $message, 
=> $result 


‘message! 
'result' 
); 


exit; 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


从 上 述 代码 中 可 以 看 出 ，render 方 法 的 主要 逻辑 都 在 处 理 $result 变 量 ， 也 就 是 JSON 数 据 中 的 result 字 段 。 程 序 循环 获取 $result 数 据 中 的 键 名 (key) 和 数值 (value) ， 并 按照 微 博 应 用 通信 协议 的 设 


计 ， 通 过 判断 键 名 的 格式 (模型 名 .list 表 示 对 象 数 组 ) 来 分 别处 理 单个 对 象 和 对 象 数组 的 逻辑 。 另 外 ， 这 里 还 用 到 了 M 方 法 来 格式 化 模型 的 数据 。 此 方法 与 数据 模型 的 定义 放 在 一 起 ， 即 etc/ 目 录 下 的 
global.datamap.php 文 件 中 ， 如 代码 清单 9-6 所 示 。 


代码 清单 ”9-6 


// 数据 模型 数组 
$ DataMap = array( 
'Customer' => array( 
'id! => 'id', 
'sid' => 'sid', 
'name' => 'name', 
‘sign’ => 'sign!, 
"face' => 'face', 
"faceurl' => 'faceurl', 
"plogcount' => 'blogcount!, 
'fanscount' => 'fanscount', 
‘uptime => ‘uptime', 


), 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


); 
// 格式 化 数据 模型 
function M ($model, $data) 
{ 
global $ DataMap; 
$dataMap = isset($ DataMap[$model]) ? $ DataMap[$model] : null; 
if (SdataMap) { 
SdataRes = array(); 
foreach ((array) $data as $k => $v) { 
if (array key exists ($k, $dataMap)) { 
$mapKey = $dataMap [$k]; 
$dataRes [$mapKey] = $v; 
$ 
f 


return $dataRes; 


return $data; 


通过 分 析 ， 我 们 可 以 看 出 M 方 法 实际 上 就 是 根据 $_DataMap 数 组 中 的 模型 定义 来 格式 化 JSON 数 据 返 回 ， 通 过 此 方法 处 理 返回 的 数据 一 定 会 满足 $_DataMap 中 的 模型 定义 ， 这 样 就 保证 了 JSON 返 回 数 


据 的 正确 性 ， 就 算 我 们 在 程序 中 写 错 了 某 个 消息 字段 ， 也 不 会 在 返回 的 JSON 数 据 中 出 现 ， 这 也 从 某 种 角度 上 保证 了 JSON 协 议 的 通用 性 。 


虽然 ， 以 上 逻辑 会 有 一 定 的 计算 量 ， 但 是 为 了 保证 系统 的 稳定 和 安全 ， 这 点 系统 资源 消耗 还 是 非常 值得 的 。 


9.2.2 ”使 用 gzip 压 缩 


优化 数据 传输 除了 要 对 数据 本 身 进行 优化 ， 也 就 是 前 面 介绍 的 关于 JSON 协 议 的 优化 ， 还 需要 对 传输 过 程 进行 优化 。 数 据 从 服务 端 到 客户 端的 过 程 需要 通过 复杂 的 网 络 ， 因 此 影响 数据 传输 的 因素 主要 有 
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两 个 ， 其 一 是 网 络 质量 ， 如 果 网络 本 身 出 了 状况 ， 必 然 会 造成 通信 速度 缓慢 的 问题 ， 网 络 优化 相关 内 容 可 参考 9.3.3 节 ;其 二 是 数据 本 身 的 大 小 ， 数 据 越 大 传输 速度 必然 越 慢 ， 因 此 能 否 对 数据 进行 合理 的 压 


缩 就 成 了 本 节 需 要 讨论 的 问题 。 


对 于 HTTP 协 议 来 说 ，gzip 是 目前 最 主流 的 压缩 算法 之 一 ， 大 部 分 的 HTTP 服 务 器 都 支持 这 种 压缩 算法 ， 对 于 文本 消息 来 说 ，gzip 算 法 大 约 可 以 减少 70% 以 上 的 数据 尺寸 。 通 过 实际 项 目的 压力 测试 结果 
来 看 ， 对 传输 数据 进行 压缩 之 后 不 仅 会 极 大 地 缩短 请 求 响应 时 间 ， 还 可 以 大 幅度 地 提高 服务 端的 承载 能 力 。 


本 书 微 博 服务 端 使 用 的 是 Xampp 服 务 套 件 ， 其 中 HTTP 服 务 器 是 Apache。 接 着 就 来 介绍 刘 
如 果 没有 找到 deflate_module 模 块 则 需要 先 在 Apache 根 


当然 ， 并 不 是 所 有 的 文件 都 需要 压缩 的 ， 某 些 类 型 的 文件 压缩 起 来 反而 效率 比较 低 ， 比 如 图 片 、 
加 了 系统 运算 量 的 开销 。 所 以 ， 在 Apache 配 置 文件 中 我 们 可 以 通过 设置 把 这 些 文件 排除 掉 。 配 置 示例 如 代码 清单 9-7 所 示 。 


代码 清单 9-7 


0 何 为 Apache 服 务 器 配置 gzip 压 缩 功能 模块 。 首 先 ， 我们 可 以 使 
录 的 conf/httpd.conf 配 置 文 件 中 将 “LoadModule deflate module modules/mod_deflate.so” 这 行 注释 打开 ， 并 重启 服务 器 。 


“httpd-M” 命 令 来 查看 已 经 安装 的 模块 ， 


PDF 文档 等 ; 原因 是 这 些 文件 本 身 已 经 


经 被 压缩 过 了 ， 用 gzip 再 压缩 一 次 并 不 能 减 小 文件 的 大 小 ， 反 而 增 


<IfModule deflate module> 
SetOutputFilter DEFLATE 
t 不 压缩 图 片 以 及 其 他 类 型 


SetEnvIfNoCase Request URI .(?:gif|jpe?g|png)$ no-gzip dont-vary 
SetEnvIfNoCase Request URI . (?:exe|t?gz|ziplbz2|sit|rar)$ no-gzip dont-vary 
SetEnvIfNoCase Request URI .(?:pdf|doc)$ no-gzip dont-vary 


# 压缩 脚本 和 文本 类 型 文件 ` 


AddOutputFilterByType text/html text/css text/plain text/xml 
AddOutputFilterByType application/javascript application/x-javascript 


</IfModule> 


除了 Apache，Nginx 也 是 如 今 非常 流行 的 HTTP 服 务 器 ， 如 果 配 合 PHP 的 FastCGI 模 式 提供 服务 效率 应 该 不 低 于 Apache 加 mod_php 的 运行 模式 。 这 里 也 随 带 介绍 一 下 如 何 为 Nginx 服 务 器 配置 gzip 压 缩 


功能 。 我 们 需要 知道 ，Nginx 的 gzip 压 缩 功 能 默认 是 关闭 的 ， 并 且 只 对 text/html 文 件 进行 压缩 ， 配 


代码 清单 9-8 


gzip on; 
gzip_min_length 1024; 
gzip_proxied 
gzip_types 


gzip 的 值 on 或 者 off 分 别 代表 开启 或 者 关闭 gzip 压 缩 功 能 。gzip_min_length 设 置 需要 压缩 页 画 
行 压缩 。gzip_proxied 配 置 仅 在 Nginx 作 为 反 向 代理 时 使 


expired no-cache no-store private auth; 
text/plain application/x-javascript text/css text/html application/xml; 


置 示例 如 代码 清单 9-8 所 示 。 


， 这 里 不 作 详细 介绍 。gzip_types 代 表 


使 用 gzip 压 缩 传输 方案 还 需要 客户 端的 配合 ， 发 送 请 求 时 需要 带 上 gzip 相 关 的 HTTP 请 求 头 ， 接 收 到 压缩 数据 时 还 需 


的 最 小 字 节 数 ， 该 值 会 从 header 头 中 的 Content-Length 中 获取 ， 而 且 默 认 值 是 0， 即 不 管 页 面 多 大 都 进 
的 是 需要 压缩 文件 的 MIME 类 型 ， 当 然 无 论 是 否 指定 ， 


“text/html” 类 型 总 是 会 被 压缩 的 。 


F 客 户 端的 代码 实现 ， 我 们 可 以 在 7.3.1 节 中 找到 相关 的 内 容 。 


进行 解压 ， 至 了 
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9.3.1 


dk, 


其 他 优化 


除了 服务 端 处 理 逻 辑 和 数据 传输 过 程 的 优化 之 多 
HTTP 服 务 器 ， 数 据 库 服务 器 ， 缓 存 服务 器 等 ， 如 果 其 中 某 个 组 件 出 现 问题 也 会 影响 到 整个 服务 端的 性 能 ， 下 


服务 器 优化 


这 里 所 说 的 服务 器 优化 包含 Linux 服 务 器 优化 和 HTTP 服 务 器 优化 两 


， 还 有 一 些 其 他 的 优化 工作 需 


HTTP 服 务 器 作为 所 有 程 | 


Linux 服 务 器 优化 是 一 个 


序 逻 辑 的 容器 ， 当 然 也 是 非常 重 


的 ， 一 旦 出 现 问题 会 直 


我 们 注意 ， 这 里 


我 们 就 来 对 主 


H 


层 意思 。 我 们 所 有 的 服务 端 组 件 都 是 安装 在 Linux 服 务 器 上 面 
影响 到 整个 服务 的 质量 。 下 面 我 们 就 这 两 方 


的 内 容 给 大 家 分 别 介绍 一 下 。 


H 


net.ipv4.tcp max syn backlog = 8192 


以 上 配 


于 设置 网 络 接 [ 


net.core.netdev_max_backlog = 4096 


庞大 的 主题 ， 这 里 说 的 优化 工作 主要 是 针对 Linux 网 络 功能 的 优化 。 下 面 我 们 将 对 Linux 系 统 参数 中 与 


络 有 关 的 重要 参数 进行 详细 介绍 。 


介绍 的 主要 是 与 服务 端 组 件 有 关 的 优化 。 我 们 都 知道 应 用 服务 端 通常 是 由 多 个 组 件 配合 运转 的 ， 比 如 
服务 端 组 件 的 优化 工作 进行 介绍 。 


的 ， 如 果 服 务 器 性 能 出 现 问题 ， 必 将 影响 到 整个 服务 端的 性 能 和 稳定 。 另 


接收 数据 包 的 速率 快 于 内 核 处 理 速 率 时 ， 人 允许 被 送 到 队列 的 数据 包 的 最 大 数目 ， 参 数 默认 值 是 1024， 增 加 该 参数 值 可 以 提升 大 访问 量 情况 下 系统 的 承载 能 力 。 


以 上 配 


于 设 


net.core.somaxconn = 4096 


以 上 配 


net.core.wmem_ default = 8388608 


net.core. 
net.core. 
net.core. 


以 上 配 


net.ipv4. 


以 上 配 


net.ipv4. 
net.ipv4. 


tcp syncookies = 1 


tcp tw recycle-1 
tcp tw _ reuse=1 


以 上 配 


net.ipv4. 


以 上 配 


rmem default = 8388608 
rmem max = 16777216 
wmem max = 16777216 


于 开启 SYN Cookies 功 能 ， 即 当 出 现 SYN 队 列 溢 出 时 ， 启 上 


于 打开 Socket 套 接 字 的 快速 回 


收 和 重 


tcp_keepalive_time = 1800 


功能 ， 增 加 此 参数 值 对 了 


cookies 来 处 理 ， 可 上 


防范 少量 SYN 攻 击 。 


F 存 在 大 量 连接 的 Web 服 务 器 非常 有 效 。 


需要 保存 在 队列 中 的 TCP 未 确认 连接 的 最 大 数目 ， 参 数 默 认 值 是 1000， 增 加 该 参数 值 可 以 从 一 定 程度 上 抵御 SYN 洪 水 攻击 。 


于 设置 Socket 套 接 字 (AF INET 类 型 ) 的 最 大 人 允许 连接 数 ， 参 数 默认 值 是 128， 增 加 该 参数 值 可 以 提升 Socket 套 接 字 的 并 发 能 力 。 


于 设置 Socket 套 接 字 的 最 大 系统 发 送 缓存 (wmem) 和 接收 缓存 (mem) 参数 默认 值 均 为 16MB， 增 加 该 参数 值 可 以 提升 Socket 服 务 的 处 理 速度 。 


于 减少 KeepAlive 连 接 侦 测 的 时 间 ， 让 系统 可 以 处 理 更 多 的 连接 。 


此 外 ， 上 述 服务 器 系统 参数 优化 的 具体 步骤 如 下 : 首先 ， 打 开 Linux 系 统 的 /etc/sysctl.conf 文 件 ， 对 需要 优化 的 系统 内 核 参 数 进行 设置 ， 其 次 ,执行 “sysctl-p” 命 令 让 参数 修改 即时 生效 ; 最 后 ， 执 
“sysctl-algrep net” 命令 验证 修改 结果 。 


接 下 来 我 们 来 学 习 如 何 优化 Apache 


的 MPM 模 式 ， 目 前 最 主 


1.prefork 模 式 


prefork 模 式 是 Apache 在 Linux 平 台 上 默认 的 MPM SKF 


. EF 


BSMPMISSUGPSER, B 


肛 务 器 。 必 须 先 了 解 多 路 处 理 模块 MPM (Multi Processing Modules) 的 


< 


To 


prefork 模 式 和 worker 模 式 ， 下 


的 预 派生 子 进程 方式 来 处 理 请 求 ， 进 程 之 间 是 彼此 独立 的 ， 相 对 比较 稳定 。 安 装 之 后 我 们 可 以 使 


H 


我 们 分 别 进 行 介绍 。 


实际 上 在 安装 Apache 的 时 候 ， 我 们 就 需要 使 有 


with-mpm 参 数 来 选择 需要 使 


httpd-| 命 令 来 确定 当前 使 有 


的 


MPM (prefork.c 和 worker.c 分 别 表示 prefork 模 式 和 worker 模 式 ) 。 安 装 后 查看 Apache 默 认 配置 文件 httpd.conf (Apache 2.0 以 上 是 extra/httpd-mpm.conf) ， 可 以 发 现 如 代码 清单 9-9 所 示 的 配置 信 
息 。 


建 两 个 ， 接 着 再 等 待 一 秒 钟 ， 继 续 创建 四 


代码 清单 9-9 


<IfModule prefork.c> 
StartServers 5 
MinSpareServers 5 
MaxSpareServers 10 
MaxClients 150 
MaxRequestsPerChild 0 
</IfModule> 


个 ， 如 此 按 指数 增长 创建 的 进程 数 ， 最 多 达到 每 秒 32 个 ， 直 


必 在 请 求 到 来 时 再 产生 新 的 进程 ， 从 而 减 小 了 系统 开销 ， 增 强 了 性 能 。 


MaxSpareServers 设 置 了 Apache 最 大 的 空闲 进程 数 ， 如 果 空 闲 进程 数 大 于 这 个 值 ，Apache 会 


> 


下 面 我 们 结合 prefork 模 式 的 工作 原理 来 认识 这 些 参数 的 功能 。Apache 主 进程 在 最 初 建立 StartServers 个 子 进程 后 ， 为 了 满足 MinSpareServers 设 置 的 需要 ， 先 创建 一 个 进程 ， 然 后 等 待 一 秒 钟 ， 继 续 创 
到 满足 MinSpareServers 设 置 的 值 为 止 。 其 实 ， 这 就 是 预 派 生 模式 (prefork) 的 由 来 。 这 种 模式 可 以 不 


动 杀 死 一 些 多 余 进 程 。MaxRequestsPerChild 设 置 的 是 每 个 子 进程 可 处 理 的 请 求 数 ， 可 根据 服务 器 的 负 


载 来 调整 这 个 值 。MaxClients 是 这 些 参数 中 最 为 重要 的 一 个 ， 设 定 的 是 Apache 可 以 同时 处 理 的 请 求 ， 该 参数 对 Apache 性 能 影响 最 大 ， 理 论 上 该 值 越 大 ， 可 以 处 理 的 请 求 就 越 多 ， 对 于 负载 较 高 的 站 点 来 说 


2.worker 模 式 


worker 模 式 是 Apache 2.0 新 出 现 的 支持 多 线程 和 多 进程 混合 模型 的 MPM。 由 了 
到 处 理 大 量 请 求 的 目的 。 这 种 MPM 的 工作 方式 将 成 为 Apache 2.0 的 发 


其 默认 值 150 是 不 够 的 ， 我 们 可 以 根据 硬件 配置 和 负载 情况 来 动态 调整 这 个 值 。 


使 


线程 来 处 理 ， 所 以 系统 资源 的 开销 要 小 


Fperfork 模 式 。worker 模 式 在 每 个 进程 中 使 


于 查看 Apache 默 认 配 置 文件 ， 可 以 发 现 如 代码 清单 9-10 所 示 的 配置 信息 。 


多 个 线程 来 处 理 请 求 ， 以 达 


代码 清单 9-10 


<IfModule worker.c> 
StartServers 
MaxClients 150 
MinSpareThreads 25 
MaxSpareThreads 75 
ThreadsPerChild 25 
MaxRequestsPerChild 0 
«/IfModule» 


worker 模 式 的 工作 原理 是 ， 由 主 进 程 生成 StartServers 个 子 进程 ， 每 个 子 进程 中 包含 固定 的 ThreadsPerChild 线 程 数 ， 每 个 线程 独立 地 处 理 请 求 。 在 该 模式 中 ， 系 统 使 用 了 类 似 线程 池 的 概 
念 ，MinSpareThreads 和 MaxSpareThreads 分 别 设置 了 最 少 和 最 多 的 空闲 线程 数 ， 而 MaxClients 则 设置 了 所 有 子 进程 中 的 线程 总 数 。 如 果 现 有 子 进程 中 的 线程 总 数 不 能 满足 负载 ， 控 制 进程 将 派生 新 的 子 


进程 。 


MinSpareThreads 和 MaxSpareThreads 的 最 大 默认 值 分 别 是 75 和 250， 这 两 个 参数 对 Apache 的 性 能 影响 并 不 大 ， 可 以 按照 实际 情况 做 相应 调节 。ThreadsPerChild 是 worker 模 式 中 与 性 能 相关 最 密切 
的 指令 ， 对 于 负载 较 高 的 站 点 其 默认 值 64 是 不 够 的 ， 理 论 上 该 值 越 大 能 处 理 的 请 求 就 越 多 ， 但 是 也 不 能 把 这 两 个 值 调 得 太 高 ， 如 果 超 过 系统 的 处 理 能 力 ， 会 导致 Apache 系 统 不 稳定 。MaxClients 表 示 并 发 
处 理 客户 端 请 求 的 最 大 线程 数 ， 此 参数 需要 与 ServerLimit 和 ThreadsPerChild 配 合 使 用 ， 假 如 我 们 把 ServerLimit 设 置 为 16，ThreadsPerChild 设 置 为 64， 那 么 MaxClients 则 必须 是 两 者 的 乘积 ， 即 1024。 


另外 ， 我 们 还 需要 知道 的 是 ，Apache 服 务 器 对 HTML 静 态 文件 的 解析 效率 比 PHP 脚 本 高 得 多 ， 所 以 ， 如 果 有 可 能 的 话 可 以 把 某 些 页 面 静态 化 ， 这 也 可 以 算是 对 服务 器 的 另 一 种 优化 。 当 然 ， 这 个 过 程 需 
要 借助 PHP 程 序 来 实现 ， 这 也 是 许多 CMS 系统 正在 做 的 事情 。 


932 ”数据 库 优化 


在 LAMP 架 构 中 ， 数 据 库 即 MySQL。 对 MySQL 的 优化 工作 可 以 大 致 分 为 两 方面 ， 一 方面 是 SQL 语句 的 优化 ， 因 为 PHP 程 序 对 数据 库 的 所 有 操作 都 是 使 用 SQL 语句 来 执行 的 ， 这 里 面 有 不 少 需要 注意 的 地 
方 ; 另 一 方面 则 是 数据 库 服务 器 的 架构 优化 ， 面 对 着 日 益 增 加 的 访问 量 和 数据 量 ， 我 们 需要 有 良好 的 数据 库 架 构 布 局 ， 最 大 限度 地 提高 整个 系统 性 能 。 


1.SQL 优 化 


在 进行 SQL 优化 之 前 ， 我 们 首先 需要 了 解 哪些 SQL 需要 进行 优化 。 我 们 可 以 为 数据 库 设置 慢 查 询 (Slow Query) 日 志 ， 还 可 以 在 SQL 控制 台 输入 show status like 'Slow%' 语句 来 查看 当前 慢 查询 的 
数量 。 慢 查询 日 志 的 设置 很 简单 ， 在 MySQL 数 据 库 配置 文件 my.cnf 中 加 入 相应 的 配置 选项 即 可 ， 配 置 示例 如 代码 清单 9-11 所 示 。 


代码 清单 9-11 


+ 慢 查 询 日 志 位 置 
log-slow-queries=/path/to/slow-query. log 
# 慢 查 询 的 时 间 

long query time-2 

# 记录 不 使 用 索引 的 SQL 语句 


log-queries-not-using-indexes 


以 上 配置 选项 的 含义 在 注释 中 已 经 说 得 很 清楚 了 ， 所 有 查询 时 间 大 于 2 秒 的 SQL 和 没有 使 用 索引 的 SQL 都 会 被 保存 到 slow-query.log 中 ， 然 后 我 们 就 可 以 把 这 些 比较 慢 的 SQL 拿 出 来 ， 进 行 逐 个 分 析 。 分 
析 单 条 SQL 时 需要 使 用 EXPLAIN 语 句 ， 即 只 要 在 SELECT 语句 前 面 加 上 EXPLAIN 关 键 词 ， 结 果 中 便 会 显示 对 应 SQL 语句 的 运行 细节 ， 如 查询 类 型 (select type) 、 表 连接 类 型 (type) 、 使 用 索引 (key) 、 
结果 行 数 (rows) 等 信息 。 


(1) 使 用 索引 


根据 实际 项 目的 经 验 来 看 ， 绝 大 部 分 的 慢 查询 都 与 索引 的 使 用 有 关 ， 使 用 索引 的 查询 语句 效率 要 大 大 高 于 普通 查询 ， 对 于 那些 行 数 大 于 10 万 的 数据 表 来 说 ， 执 行 速 度 的 差距 会 特别 明显 。 要 判断 哪些 字 
段 需 要 索引 ， 我 们 可 以 从 WHERE 子 句 中 下 手 。 简 单 来 说 ， 使 用 确定 性 的 判断 条 件 的 字段 需要 加 索引 ， 这 些 条件 符 号 包括 >、>=、=、<、<=、IS NULL、IN 和 BETWEEN 等 ; 如 果 是 like 查 询 的 话 ， 则 要 看 
通配符 的 位 置 ， 比 如 like 'ames%' 可 以 使 用 索引 ， 而 like '%james%' 则 不 能 使 用 索引 。 


对 于 我 们 来 说 ， 一 方面 要 注意 SQL 的 写法 ， 尽 量 使 用 确定 性 的 判断 ， 不 确 性 的 判断 要 尽量 少 用 ， 比 如 ! =. IS NOT NULL, NOT IN 等 ; 另 一 方面 需要 根据 查询 的 条 件 来 合理 地 创建 索引 ， 由 于 索引 是 非 
常 占 空间 的 ， 所 以 注意 不 要 过 量 创建 索引 。 


(2) 慎 用 表 关 联 


关联 查询 是 关系 数据 库 的 一 项 重要 功能 ， 常 用 的 关联 关系 有 内 联 (INNER JOIN) 和 左 关联 (LEFT JOIN) 两 种 ， 由 于 每 次 进行 关联 查询 时 都 要 对 两 张 数据 表 数 据 的 笛 卡 儿 乘积 进行 查询 ， 扫 描 的 数量 非 
常 大 ， 所 以 我 们 在 设计 时 应 该 尽量 使 用 添加 宛 余 字段 的 方式 来 避免 表 关联 ， 这 也 是 一 种 用 空间 换 时 间 的 优化 方法 。 


如 果 在 使 用 数据 库 的 过 程 中 关联 查询 难以 避免 ， 那 我 们 需要 对 关联 的 字段 建立 索引 。 另 外 ， 虽 然 MySQL 支 持 子 查询 ， 但 是 这 种 SQL 的 效率 非常 低 ， 我 们 要 避免 使 用 。 


(3) 慎 用 耗 时 操作 


MySQL 为 我 们 提供 丰富 的 查询 条 件 和 函数 ， 但 是 我 们 需要 注意 其 中 也 有 许多 使 用 “陷阱 ”需要 我 们 警醒 。 比 如 查询 数量 时 干 万 不 要 使 用 COUNT (*) , COUNT (1) 是 更 好 的 选择 ; 如 果 不 是 非常 需 
， 尽 量 不 要 使 用 DISTINCT; GROUP BY 计算 也 是 非常 消耗 资源 的 。 另 外 ， 有 些 人 为 了 方便 ， 喜 欢 使 用 MySQL 提 供 的 函数 ， 比 如 MAX () 、MIN () 、SUBSTR () 、CONCAT () 、 
DATE FORMAT () 、TO_DAYS () 等 ， 实 际 上 这 反而 会 加 大 数据 库 的 负担 。 原 则 上 ， 我 们 应 该 尽量 让 数据 库 专心 负责 查询 方面 的 工作 ， 其 他 的 耗 时 操作 应 交 给 PHP 程 序 。 


2. 最 主流 的 MySQL 数 据 库 架构 


学 习 完 SQL 优化 的 相关 知识 ， 相 信 大 家 对 MySQL 数 据 库 基本 功能 的 使 用 有 了 比较 正确 的 理解 。 接 下 来 ， 我 们 来 看 看 如 何 通过 数据 库 架 构 的 优化 来 应 付 高 访问 量 和 大 数据 量 的 挑战 。 下 面 我 们 将 介绍 两 种 
业界 最 主流 的 MySQL 数 据 库 架 构 。 


(1) 主 从 结构 (Master/Slave) 


所 谓 Master/Slave 结 构 就 是 我 们 常 说 的 主 从 结构 ， 主 库 负责 数据 写 入 ， 从 库 负 责 数据 查询 ， 主 库 写 入 数据 之 后 会 快速 同步 到 从 库 以 保证 数据 的 完整 性 。 图 9-3 是 该 结构 的 架构 示意 
MySQl 数 据 库 的 主 从 复制 (Replication) 功能 来 支持 。 


D 
x 
8 
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在 实际 项 目 中 我 们 经 常 采 用 一 主 多 从 的 方式 ， 即 从 一 台 主 库 同 步 数据 到 多 台 从 库 中 ， 这 种 架构 的 好 处 是 既 能 避免 同时 读 写 造成 的 锁 表 问题 ， 又 能 通过 多 台 从 库 分 担 访问 量 ， 还 能 保证 数据 的 安全 性 ， 就 
算 主 库 出 问题 了 ， 还 可 以 把 数据 从 某 台 从 库 恢 复 回 去 。 实 际 上 ， 这 种 架构 已 经 可 以 应 付 大 部 分 的 情况 了 。 


然 主 从 结构 对 分 散 查询 请 求 、 增 加 系统 负载 有 较 大 的 帮助 ， 但 是 如 果 使 用 不 当 ， 也 容易 造成 逻辑 问题 ， 这 就 是 我 们 常 说 的 “ 主 从 同步 问题 ”。 比 如 ， 用 户 在 修改 某 些 信息 时 ， 程 序 逻 辑 会 先 在 主 库 上 
进行 更 新 ， 然 后 再 从 从 库 中 获取 数据 ， 假 如 此 时 同步 不 够 及 时 ， 就 会 出 现 修改 后 的 信息 没有 变化 的 现象 。 对 于 这 种 情况 ， 我 们 在 编码 时 需要 特别 注意 ， 尽 量 保证 这 种 存 取 间 隔 很 短 的 逻辑 在 相同 的 数据 库 中 


操作 。 


(2) 集群 (Cluster) 


Cluster 即 数据 库 集群 ， 当 访问 量 和 数据 量 达 到 另 一 个 程度 ， 比 如 干 万 以 上 级 别 的 情况 ， 普 通 的 主 从 结构 已 经 很 难 满足 这 种 


加 灵活 的 架构 来 解决 这 个 问题 。 图 


9-4 就 是 一 个 标准 Cluster 架 构 的 示意 


图 。 


图 9-3 ”MySQL 的 主 从 结构 


求 ， 要 知道 同时 同步 N 台 从 库 的 成 本 也 是 很 高 的 ， 此 时 我 们 就 需要 有 一 个 更 


图 9-4 ”MySQL 集群 布局 


我 们 可 以 看 到 以 上 的 数据 库 集群 (Cluster) 结构 是 由 很 多 独立 的 Master/slave 集 合 构成 的 ， 所 有 的 程序 模块 都 通过 统一 的 分 布 式 程序 模块 来 访问 数据 库 。 这 种 方式 的 好 处 是 可 以 灵活 地 使 用 程序 逻辑 ， 
把 海量 的 数据 分 散 到 对 应 的 Master/Slave 数 据 库 集合 中 。 除 了 具备 灵活 性 的 优点 以 外 ， 良 好 的 扩展 性 也 是 该 集群 架构 的 优点 之 一 ， 理 论 上 只 要 通过 修改 分 布 式 程序 的 算法 ， 就 可 以 在 这 个 架构 上 添加 无 限 的 
Master/Slave 集 合 。 


cluster 架构 对 数据 库 管 理 和 分 布 式 逻辑 的 要 求 比较 高 ， 一 旦 逻辑 出 了 问题 通常 会 造成 非常 严重 的 后 果 。 程 序 实现 思路 如 下 ， 首 先 ， 我 们 通常 会 使 用 唯一 的 字段 作为 分 布 式 数据 的 ID， 通 过 散 列 分 布 算法 
来 获得 数据 所 在 的 位 置 ， 目 前 比较 常见 的 算法 有 取 模 算法 、 一 致 性 散 列 算法 等 。 至 于 具体 的 实现 逻辑 ， 这 里 就 不 深究 了 。 


另外 ，Hush Framework 中 还 实现 了 另外 一 种 思路 的 分 布 式 算法 ， 即 按照 数据 库 名 来 分 布 式 存储 数据 。 这 种 算法 虽然 比较 简单 ， 但 是 在 实际 项 目 中 还 是 非常 实用 的 ， 由 于 数据 库 的 相关 功能 不 同 ， 每 个 
数据 库 的 访问 量 和 数据 量 也 很 不 平均 ， 所 以 按照 数据 库 名 来 处 理 还 是 比较 科学 的 ， 有 兴趣 的 读者 可 以 参考 微 博 服务 端 程序 中 数据 库 配 置 的 实现 ， 代 码 位 于 服务 端 程序 的 etc/ 目 录 下 的 database.mysql.php 文 
件 中 。 


933 ”网 络 优化 


前 面 已 经 介绍 了 许多 与 应 用 服务 端 有 关 的 优化 ， 相 信 如 果 都 能 做 到 ， 该 网 络 应 用 的 服务 端 性 能 应 该 已 经 相当 不 错 了 。 不 过 在 正式 上 线 之 前 ， 我 们 还 有 个 比较 重要 的 问题 需要 考虑 ， 也 就 是 网 络 机 房 的 选 
择 。 


目前 国内 有 移动 、 联 通 和 电信 三 大 移动 网 络 运营 商 ， 不 同 运营 商 的 网 络 之 间 会 有 一 定 的 分 隔 ， 有 过 运 维 经 验 的 人 应 该 都 知道 ， 在 不 同 网 络 之 间 进 行 数据 传输 的 速度 肯定 要 比 网 内 传输 慢 得 多 。 因 此 ， 对 
于 移动 互联 网 应 用 来 说， 要 把 服务 端 部 署 在 哪 种 机 房 就 需要 慎重 考虑 了 。 当 然 ， 如 果 资 金 充 足 也 可 以 选用 双 线 甚至 多 线 机 房 ， 但 是 对 于 创业 初期 的 团队 来 说 就 需要 谨慎 选择 了 。 


一 个 比较 合理 的 思路 是 根据 目标 用 户 的 分 布 来 选择 机 房 。 从 国内 的 Android 市 场 看 ， 移 动用 户 应 该 是 最 多 的 ， 联 通 和 电信 其 次 ， 但 是 应 用 真实 的 用 户 分 布 还 是 需要 通过 实际 数据 来 说 明 。 为 了 收集 这 些 
数据 ， 使 用 一 些 Android 数 据 统计 平台 是 一 个 不 错 的 选择 。 走 完 这 个 步骤 之 后 ， 应 用 就 进入 运营 阶段 了 ， 服 务 端 开 发 也 将 进入 支持 维护 阶段 。 


9.4 小 结 


本 章 内 容 比 较 全 面 地 介绍 了 PHP 服 务 端 开 发 过 程 中 各 个 方面 的 优化 。 首 先 ， 重 点 介绍 了 与 PHP 编 码 过 程 以 及 PHP 系 统 组 件 (如 Session、 缓 存 、APC 等 ) 的 优化 ; 其 次 ， 分 析 并 介绍 了 网 络 数据 传输 过 程 
中 可 能 需要 注意 到 的 优化 技巧 最后， 我们 还 介绍 了 可 能 会 影响 服务 端 运 行 效率 的 其 他 几 个 重要 因素 ， 包 括 服务 器 优化 、 数 据 库 优化 以 及 网 络 优化 的 内 容 。 这 些 优化 技巧 和 经 验 都 是 从 实际 项 目 中 积累 而 来 
的 ， 具 有 很 高 的 实用 价值 。 


第 10 章 “客户 端 优化 


对 于 移动 互联 网 应 用 来 说， 客户 端的 功能 主要 是 提供 展示 和 操作 的 界面 ， 为 用 户 提供 良好 的 使 用 体验 。 通 过 之 前 对 服务 端 性 能 瓶颈 的 分 析 ， 我 们 了 解 到 客户 端的 优化 的 主要 目的 就 是 让 应 用 客户 端 能 够 
运行 得 更 快 、 更 稳 ， 优 化 工作 主要 包括 Android 程 序 优化 、Android UI 优化 以 及 一 些 其 他 的 优化 。 下 面 我 们 先 来 介绍 与 Android 程 序 优化 有 关 的 内 容 。 


10.1 优化 Android 程 序 


Android 程 序 优化 是 客户 端 优化 的 核心 ， 因 为 应 用 客户 端的 逻辑 都 需要 使 用 Android 程 序 来 实现 ， 包 括 数据 准备 、 逻 辑 计算 、 资 源 调用 以 及 缓存 使 用 等 。 另 外 ， 在 客户 端 优化 中 还 需要 特别 注意 内 存 泄露 
的 问题 ， 否 则 可 能 造成 应 用 程序 骨 溃 的 后 果 。Android 程 序 优化 包括 许多 方面 ， 下 面 重 点 介绍 Java 代 码 优化 、 多 线程 的 应 用 以 及 常用 的 缓存 策略 。 


Ej 


103.1. 优化 Java 代 码 


既然 Android 应 用 客户 端 使 用 的 是 Java 语 言 ， 就 免不了 需要 进行 Java 代 码 优化 的 工作 。 和 服务 端 代码 优化 一 样 ， 在 客户 端 编码 工作 完成 之 后 ， 也 会 有 Code Review 的 过 程 ， 在 这 个 过 程 中 我 们 需要 使 
一 些 常 见 的 Java 编 程 技 巧 ， 并 结合 实际 的 逻辑 来 不 断 地 “锤炼 ”我 们 的 代码 ， 以 达到 缩减 代码 体积 和 提高 代码 执行 效率 的 目的 。 下 面 我 们 先 来 学 习 一 些 常见 的 Java 编 程 技巧 和 优化 原则 。 


1. 尽 量 使 用 static 和 final 修 饰 符 


使 用 静态 修饰 符 static 的 好 处 有 很 多 ， 对 于 一 些 固定 的 类 和 方法 我 们 都 建议 使 用 static 把 它们 标识 为 静态 ， 因 为 相对 于 其 他 方式 调用 静态 方法 的 效率 是 最 高 的 ， 而 且 可 以 减少 空间 占用 ， 这 点 所 有 的 语言 
都 一 样 ， 当 然 也 包括 PHP。 


final 修 饰 符 有 “无 法 改变 ”的 含义 ，final 变 量 的 值 不 可 被 修改 ，final 方 法 不 可 被 覆盖 ，final 类 不 可 派生 。 适 当地 使 用 final 修 饰 符 不 仅 可 以 保护 重要 的 逻辑 或 者 数据 ， 还 可 以 提高 程序 的 执行 效率 。 


2. 尽 量 使 用 局 部 变量 


调用 方法 逻辑 时 创建 的 局 部 变量 (临时 变量 ) 是 保存 在 栈 (Stack) 中 的 ， 速 度 要 比 保存 在 堆 (Heap) 中 的 那些 变量 快 许多 ， 如 静态 变量 、 实 例 变量 等 。 


3. 不 要 过 度 依赖 GC 


虽然 Java 虚 拟 机 自身 的 GC 垃 圾 回收 机 制 已 经 比较 完善 ， 但 是 同时 也 掩盖 了 一 些 风险 。 比 如 在 短 时 间 内 大 量 地 创建 对 象 就 有 可 能 会 消耗 过 多 的 系统 内 存 ， 从 而 导致 内 存 泄露 ， 因 此 ， 我 们 还 是 应 该 养 成 及 
时 回收 不 再 使 用 的 对 象 和 资源 的 好 习惯 。 常 见 的 回收 方式 就 是 在 使 用 完 变量 或 者 对 象 之 后 ， 将 其 手动 设置 为 null。 


外， 如 果 在 程序 逻辑 中 使 用 到 数据 库 连 接 或 者 MO 流 这 种 大 对 象 时 务必 特别 小 心 ， 使 用 后 应 该 及 时 进行 资源 释放 ， 因 为 操作 这 些 大 对 象 对 系统 资源 的 开销 比较 大 ， 使 用 不 当 则 有 可 能 导致 严重 的 后 果 。 


4. 优 化 循环 语句 


和 其 他 语言 一 样 ， 当 我 们 遇 到 循环 或 者 递归 逻辑 时 ， 需 要 特别 注意 ， 因 为 在 这 种 逻辑 中 ， 一 旦 出 现 漏洞 就 有 可 能 被 无 限 放大 。 下 面 我 们 就 来 分 析 编程 中 需要 注意 的 几 个 要 点 ， 首 先 ， 在 循环 中 应 该 避免 
重复 运算 ， 相 关 示 例 见 代码 清单 10-1。 


代码 清单 10-1 


// 错误 写法 
for (int i = 0; i < vector.size(); i++) { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


l 
// 正确 写法 
int size = vector.size(); 
for (int i = 0; i < size; i++) { 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


ERRAR, vectormRANsize TES ARER, BAAD ATERRAR, BERERE ERAAI. ERS AEAN ERER, ERTEAN 
时 便 不 会 产生 额外 计算 量 。 


其 次 ， 循 环 逻辑 中 应 该 尽量 避免 使 用 一 些 开销 比较 大 的 操作 ， 比 如 创建 对 象 (new) ， 捕 获 异常 (try catch) 等 。 进 行 逻 辑 计算 时 应 该 尽量 使 用 基本 数据 类 型 ， 比 如 int 激 组 、string 数 组 等 。 变 量 或 者 
对 象 使 用 后 还 要 注意 资源 回收 。 


5. 导 用 异常 机 制 


虽然 Java 的 异常 机 制 非常 强大 ， 但 是 执行 异常 捕获 语句 (try catch) 和 抛 出 异常 (throw) 的 代价 很 高 。 建 议 大 家 在 使 用 异常 机 制 的 时 候 尽 量 把 捕获 逻辑 放 在 最 外 层 ， 并 且 只 用 于 错误 处 理 ， 不 要 


在 编程 过 程 中 难免 会 遇 到 运算 逻辑 ，Java 语 言 中 基本 的 数字 类 型 有 byte、short、int、long、float 和 double， 运 算 方法 有 加 、 减 、 乘 、 除 、 移 位 以 及 布尔 运算 。 以 下 是 实现 计算 逻辑 时 需要 注意 的 要 


“ 运算 速度 从 快 到 慢 依次 是 int、short、byte、long，float 和 double 的 运算 速度 最 慢 。 


“ 除法 比 乘 法 慢 太 多 ， 基 本 上 除法 的 运算 时 间 是 乘法 的 9 倍 。 


“ long 类 型 的 计算 很 慢 ， 建 议 少 用 。 


ble 运 算 速 度 和 float 相 当 。 


+ doul 


7. 字 符 串 操作 使 


StringBuffer 


字符 串 (String 
但 是 这 种 做 法 的 


) 是 Java 语 言 最 常 
效率 要 比 使 用 StringBuffer 慢 上 很 多 。 相 关 示 例 请 参考 代码 清单 10-2。 


m 
TI 


代码 清单 10-2 


// 低 效用 法 

String appendStr = "test"; 

int times = 10000; 

String str = ""; 

for (int i = 0; i < times; i++) ( 
str += appendStr; 


l 

// 高 效用 法 

String appendStr = "test"; 

int times = 10000; 

StringBuffer sb = new StringBuffer(); 

for (int i = 0; i < times; i++) { 
sb.append (appendStr) ; 

} 


8. 合 理 使 


数据 集合 


用 


Java 语 言 给 我 们 提供 了 丰富 的 数据 集合 来 实现 数据 存储 和 复杂 逻辑 。Java 的 数据 集合 可 大 致 分 为 两 种 类 型 ， 即 集合 结 


(Stack) 、 散 列表 (HashMap) 等 ， 这 些 数据 集合 之 间 的 关系 如 下 。 


Collection 上 List | 上 LinkedList (双向 链表 ) RrrayList (高 级 数组 ) 
Map 上 Hashtable (线程 安全 ) 上 HashMap - WeakHashMap 


Vector (线程 安全 ) | 


的 基本 数据 类 型 之 一 ， 撤 开 最 基本 的 字符 串 操作 不 谈 ， 在 程序 逻辑 中 我 们 经 常 要 对 字符 串 进 行 拼接 操作 ， 有 些 程序 员 为 了 少 写 几 行 代码 ,使 


Stack 


构 (Collection) 和 


表 结 构 (Map), F 


H 


Set 


Collection 是 最 基本 的 数 
ArrayList， 该 数据 集合 其 实 训 
HashMap 和 Hashtable 的 
了 保证 线程 安全 性 而 使 用 了 同 


集合 
ARA 


步 机 制 ， 系 统 开销 比较 大 。 


另外 ， 数 据 集合 的 功能 虽然 十 分 强大 ， 但 是 性 能 却 远 比 不 上 
性 能 差距 我 们 在 第 8 章 对 Android 客 户 端 进行 性 能 分 析 时 已 经 验证 过 了 ， 


体内 容 可 参考 8.1.2 节 。 


区 别 ， 虽 然 同 样 是 散 列 列表 ， 但 是 Hashtable 是 同步 的 ， 即 线程 安全 的 。 另 外 ， 这 些 数据 集合 中 应 该 尽量 使 


原生 的 数据 结构 ， 比 如 数组 、 枚 举 类 型 等 。 在 编码 实现 时 ， 我 们 应 当 尽 量 使 


来 拼接 字符 


还 包含 了 列表 (List) - i 


口 ，List 是 有 序 的 Collection ， 能 够 精确 地 控制 每 个 元 素 插入 的 位 置 ，List 之 下 还 包含 LinkedList、ArrayList、Vector 和 Stack 等 数据 集合 。 其 中 ， 最 经 常 被 使 
证 一 个 可 变 大 小 的 数组 ; 其 次 是 LinkedList， 该 数据 集合 可 用 于 实现 栈 (stack) ， 队 列 (queue) 或 双向 队列 (deque) 。 此 外 ， 在 Map 类 型 的 数据 集合 中 我 们 要 注意 
Vector 和 Hashtable， 


ArrayList&]HashMap, i&&fs 


9. 使 用 clone 蔡 代 new 
我 们 知道 ， 每 次 使 用 new 关 键 词 创 建 对 象 时 都 会 比较 耗费 系统 资源 ， 因 为 所 有 类 关系 链 上 的 构造 方法 都 会 被 自动 调用 ， 但 是 使 


clone 方 法 是 一 个 更 好 的 选择 ， 相 关 示 例如 代码 清单 10-3 所 示 。 


代码 清单 10-3 


// 低 效 用 法 
public static Blog getNewBlog () { 
return new Blog(); 


l 
// 高 效用 法 
private static Blog baseBlog = new Blog(); 
public static Blog getNewBlog () { 
return (Blog) baseBlog.clone(); 
} 


clone 方 法 来 复制 对 象 不 会 调 


任何 类 的 构造 方法 ， 


的 是 


因为 后 两 者 为 


原生 的 数据 结构 来 实现 逻辑 。 实 际 上 ， 这 两 种 实现 方式 之 间 的 


因此 在 工厂 模式 下 使 


其 一 ， 如 果 一 个 变量 或 者 数据 被 这 样 声明 ， 那 么 我 们 就 不 能 对 这 个 变量 进行 任何 修改 了 ， 这 种 数组 也 无 法 进行 增 、 删 、 改 以 及 排序 等 操作 ; 其 二 ， 这 种 


10. 愤 用 public static final 
需要 谨慎 使 用 public static final 的 原因 有 两 个 。 
声明 的 数据 在 整个 进程 被 销毁 之 前 都 会 常 驻 内 存 ， 使 用 不 当 有 可 能 会 引起 一 些 性 能 问题 。 
11. 采 用 对 象 池 提高 效率 
我 们 知道 创建 和 释放 对 象 都 会 占用 比较 大 的 系统 资源 ， 而 Java 又 恰恰 是 一 门 完 全 面向 对 象 的 语言 ， 使 用 过 程 中 无 法 避免 使 


对 象 ， 所 以 就 出 现 了 对 象 池 技 术 ， 即 把 常用 的 对 象 存放 在 一 个 对 象 池 (也 可 


视 为 对 象 集合 ) 中 ， 通 过 一 定 的 策略 来 高 效 地 调 


已 经 存在 的 对 象 ， 避 免 大 量 地 创建 对 象 或 销毁 对 象 。 


Java 中 比较 常见 的 对 象 池 有 数据 库 连 接 池 、 线 程 池 等 。 比 如 我 们 在 实现 微 博 应 


考 7.4.2 节 。 


12. 不 要 过 度 使 


OOP 


对 象 既 占 内 存 ， 又 消耗 资源 ， 因 此 我 们 在 编程 实现 的 过 程 中 一 定 


客户 端 异 步 任务 时 ， 就 用 到 了 ExecutorService 线 程 池 类 中 的 newCachedThreadPoo 上 方法 创建 的 线程 池 ， 具 体内 容 可 参 
注意 ， 干 万 不 要 想当然 地 觉得 任何 问题 都 必须 使 用 OOP 的 思想 去 解决 ， 有 些 比较 简单 的 逻辑 或 者 运算 完全 可 以 使 用 基本 数据 类 型 蔡 代 


对 象 来 实现 。 


此 外 ， 在 优化 代码 的 过 程 中 ， 除 了 需要 注意 前 


面 介绍 的 Java 编 程 技 巧 ， 善 于 使 


比 我 们 
的 。 此 外 ,使 


Log 打 印 日 志 的 系统 资源 开销 也 是 不 小 的 ， 所 以 这 


10.1.2 ”异步 获取 数据 


移动 互联 网 应 


自己 实现 的 方法 要 好 。 例 如 android.util 类 包 就 为 我 们 提供 了 非常 实用 工 


必然 要 去 服务 端 获取 数据 ， 由 于 网 络 获取 数据 的 操作 通常 都 比较 耗 时 ， 


语言 框架 中 的 工具 类 也 是 非常 重要 的 ， 因 为 绝 大 部 分 的 原生 工具 类 都 是 经 过 大 师 们 精心 设计 的 ， 在 执行 效率 方面 一 般 会 
类 ， 如 Log 日 志 处 理 类 、Base64 编 码 类 以 及 Timer 定 时 器 类 等 。 使 用 android.text.TextUtils 进 行 字符 串 操作 也 是 非常 方便 


建议 大 家 ， 在 正式 发 布 应 用 之 前 应 该 先 把 程序 中 的 Log 调 试 代码 关闭 。 


因此 我 们 绝 不 可 以 把 这 些 逻 辑 放 到 主 UI 线 程 中 去 ， 否 则 很 可 能 导致 应 用 运行 缓慢 甚至 崩溃 。 正 确 的 做 法 是 在 新 线 


程 中 准备 数据 ， 然 后 再 通知 主 UI 线程 异步 获取 数据 并 显示 。 这 也 是 Android 多 线程 技术 的 一 个 重要 应 用 ， 至 于 Android 系 统 线程 的 工作 原理 请 参考 7.4.1 节 的 内 容 。 


实际 上 ， 除 了 通过 网 络 获取 数据 的 操作 之 外 ， 所 有 的 耗 时 操作 也 都 需 


使 因 


片 、 批 量 保存 数据 等 ， 这 在 Android 优 化 过 程 中 是 非常 重要 的 ， 


为 如 果 处 理 不 当 将 严重 影 


类 似 的 方式 来 处 理 ， 比 如 下 载 


D 


因此 如 果 在 Code 


的 运行 效率 ， 


响应 


接着 我 们 来 看 看 异步 获取 数据 的 方法 。 首 先 ， 在 本 书 的 微 博客 
加 入 耗 时 的 网 络 通信 逻辑 ， 然 后 在 onTaskComplete 方 法 中 处 理 异 步 返回 的 结果 。 通 过 7.4 节 的 详细 介绍 我 们 了 解 到 ， 这 种 方式 实际 上 是 利 


Review 的 过 程 中 ， 一 


发 现 使 


不 当 的 情况 ， 应 当 立 即 进行 处 理 。 


户 端 实例 中 ， 我 们 使 


f 


供 的 AsyncTask 类 来 处 理 这 个 问题 ， 这 部 分 知识 我 们 也 已 经 在 7.4.4 节 中 给 大 家 介绍 过 了 。 


1013 “文件 资源 缓存 


为 了 让 应 用 可 以 运行 得 更 加 快速 ， 


我 们 需要 使 


列表 展示 界 


面 中 ， 如 果 每 次 都 要 去 网 络 下 载 头像 


图 


SDCard 缓 存 策 


阁 的 实现 思路 是 把 网 络 
序 就 会 根据 缓存 ID 直接 从 SDCard 缓 存 文件 中 获取 到 


一 些 缓存 策略 ， 特 别 对 于 一 些 
片 必然 会 大 大 拖 慢 界 


片 的 URL 地 址 转化 成 该 
片 数据 ， 并 构造 成 Bitmap 对 象 进行 显示 。 


寸 比较 大 的 


文件 或 者 需要 从 网 络 下 载 的 


片 等 。 比 如 在 微 博 应 


Handler 来 处 理 异步 任务 的 。 除 此 之 外 ， 我 们 还 可 以 使 


实例 中 ， 微 博 


面 的 展示 效率 ， 因 此 我 们 就 采 


图 


片 的 缓存 ID， 程 序 异步 获取 


片 


实际 上 ， 上 述 缓存 的 实现 逻辑 ， 在 前 


面 第 7 章 介绍 微 博客 户 端 实 催 


ASAI ABTS 


内 容 之 后 就 会 存储 到 与 缓存 ID 对 应 的 SDCard 缓 存 文件 中 ; 这 样 当 再 次 遇 到 相同 URL 地 址 的 


了 与 SDCard 相 结合 的 缓存 策略 。 


片 时 ， 


D 


介绍 过 了 ， 具 体内 容 请 参考 本 书 的 7.7.5 节 与 7.7.6 节 。 阅 读 时 请 特别 注意 AppCache 类 中 的 


getCachedlmage ( 见 代码 清单 7-68) 、IOUtil 类 中 的 getBitmapRemote ( 见 代码 清单 7-69) 以 及 SDUtil 类 中 的 getlmage 和 savelmage 方 法 的 逻辑 代码 ( 见 代码 清单 7-71) , KERB, 


此 外 ， 在 某 些 特殊 的 情况 下 ， 我 介 


自 定义 的 doTaskAsync 和 onTaskComplete 方 法 来 创建 异步 任务 并 处 理 任务 结果 ， 通 常会 在 doTaskAsync 方 法 中 
系统 提 


的 头像 就 是 一 个 典型 的 例子 ， 在 微 博 


层 /O 类 库 的 性 能 不 是 很 理想 。 此 时 ， 推 荐 大 家 通过 MemoryFile 类 实现 高 性 能 的 文件 读 写 操作 。MemoryFile 类 通过 将 NAND 或 SDCard 上 的 文 


] 也 许 会 抱怨 Android 底 


件 分 段 映射 到 内 存 中 来 处 理 ， 这 样 就 


高 速 的 RAM 代 蔡 了 ROM 或 SDCard， 性 能 自然 提高 不 少 ， 同 时 还 减少 了 电量 消耗 。MemoryFile 类 中 主要 方法 的 使 


表 10-1 MemoryFile 类 的 主要 方法 


说 明 如 表 10-1 所 示 。 


方法 定义 使 用 说 明 
allowPurging(boolean allowPurging) 允许 清理 内 存 ， 该 操作 是 线程 安全 的 
close() 关闭 内 存 文件 句柄 
getInputStream() 获取 读 取 数 据 流 
getOutputStream() 获取 写 人 数据 流 


isPurgingAllowed() 


判断 是 否 允 许 清理 内 存 


length() 返回 内 存 映射 文件 大 小 
readBytes(byte[] buffer, int srcOffset. int destOffset. int count) 按 字 节 读 取 文件 
writeBytes(byte[] buffer. int srcOffset. int destOffset. int count) 按 字 节 写 人 文件 
10.1.4 ”数据 库 缓 存 
前 面 介 绍 了 图 片 类 型 文件 的 缓存 策略 ， 接 下 来 介绍 一 下 文本 数据 的 缓存 处 理 。 考 虑 到 图 片 类 型 文件 的 存储 和 使 用 方式 ， 我 们 采用 缓存 到 本 地 SDCard 的 方式 来 处 理 ; 而 文本 数据 则 不 同 ， 一 来 此 类 数据 可 


压缩 的 空间 比较 大 ， 二 来 可 能 需要 对 外 提供 增 、 删 、 改 、 查 业务 ， 


Android 的 本 


EPA, 具体 实现 可 参考 7.7.7 节 。 使 F 


取 最 新 的 微 博 数 据 即 可 ， 这 样 就 大 大 减少 了 不 必 


以 上 我 们 介绍 了 Android 程 序 优化 的 几 个 重要 方面 ， 以 底 
实例 好 好 理解 体会 ， 相 信 可 以 对 拓宽 Android 程 序 的 优化 思路 起 到 良好 的 作 


的 微 博 应 
断 地 发 现 和 


总 结 


=n 


10.2 ”避免 内 存 泄露 


对 于 应 用 客 


也 数据 库 是 SQLite， 一 个 高 速 的 文本 数据 库 ， 基 础 概念 可 以 参考 2.6.3 节 。 实 际 上 ， 本 书 的 微 博 应 上 
这 种 方式 有 两 种 好 处 ， 其 一 ， 客 户 端 可 以 快速 地 从 本 地 数据 库 获取 数据 ， 就 算 偶然 出 现 网 络 中 断 ， 我 们 也 可 以 看 到 微 博信 息 ; 其 二 ， 客 户 端 每 次 只 需要 到 服务 端 获 
的 网 络 流量 。 


因此 ， 我 们 通常 会 将 此 类 数据 存储 到 本 地 数据 库 中 以 便 管 理 。 


实例 就 


层 Java 代 码 的 优化 为 核心 ， 同 时 还 介绍 了 使 
。 另 外 ， 以 上 内 容 还 起 到 了 抛砖引玉 的 作 


到 了 数据 库 缓存 ， 比 如 微 博 列 表 界 


多 线程 技术 来 处 理 耗 时 操作 的 方法 ， 以 及 常 


H 


户 端 来 说 ， 如 何 避 免 内 存 泄露 是 个 老 问 题 了 。 内 存 泄露 (Memory Leak) 指 的 是 由 了 


备 运 行 。 由 于 Android 系 统 支 持 的 设备 内 存 一 般 都 不 太 高 ， 所 以 我 们 要 特别 注意 这 个 问题 。 


10.2.1 Android 内存 管 理 


内 存 管理 的 工作 也 都 由 java 虚拟 机 来 负责 。Android 系 统 使 有 


我 们 知道 Android 应 用 框架 是 基于 Java 语 言 的 ， 所 以 应 
特点 归纳 如 下 。 

“ Davlik 虚 拟 机 更 接近 Linux 内 核 ， 支 持 多 进程 。 

“Davl 让 虚拟 机 基于 寄存 器 ， 与 传统 基于 栈 的 Java 庶 拟 机 不 同 。 

* Davlik 虚 拟 机 使 用 自己 的 字 节 码 (.dex 文 件 ) ， 不 兼容 传统 的 Java 字 节 码 格式 。 
* Davlik 虚 拟 机 的 常量 池 只 使 用 32 位 的 索引 ， 以 简化 解释 器 。 

+ Davl 这 虚拟 机 默认 栈 大 小 是 12KB (3 页 、 每 页 4KB) 。 

+ Davlik Æ 4 

在 Davlik 虚 : 


孤立 对 象 就 当 作 垃圾 回收 。GC 为 了 能 够 正确 回收 对 象 ， 必 须 


WA: 
hi 


以 机 内 同样 存在 垃圾 收集 器 (GC) ， 用 于 回收 不 再 使 用 的 对 象 以 释放 内 存 ， 和 传统 的 JVM 类 似 ， 其 内 存 垃圾 


FREER 


导致 系统 内 存 过 度 消耗 的 问题 ， 在 最 糟糕 的 情况 下 ， 内 存 耗 尽 会 导致 应 有 


纪 默 认 扒 启动 大 小 是 2MB ， 最 大 为 16MB (该 数值 与 设备 有 关 ， 也 有 24MB 甚 至 48MB 的 ) o 


程序 崩溃 甚至 影 


的 是 不 遵循 JVM 规 范 的 Davlik 虚 拟 机 ， 与 传统 Java SE 的 JVM 还 是 有 些 区 别 的 ， 其 


中 的 微 博 列表 信息 就 是 被 缓存 在 SQLite 数 


的 文件 与 数据 缓存 的 技巧 ， 大 家 可 以 结合 之 前 介绍 
，Android 程 序 开发 中 还 有 更 多 的 优化 技巧 ， 等 待 着 大 家 在 实际 项 目 中 不 


响 设 


回 


控 每 个 对 象 的 运行 状态 ， 包 括 对 象 的 


收 机 制 是 从 程序 的 主要 运行 对 象 开始 检查 引用 链 ， 当 遍历 后 发 现 没有 被 引 


的 


请 、 引 用 、 赋 值 等 ， 而 释放 对 象 的 根本 原则 就 是 该 对 象 不 再 被 引用 。 另 外 ，Davlik 虚 拟 机 并 不 会 为 每 个 


对 象 保留 GC 标 记 ， 而 是 在 运行 时 再 创建 独立 的 空间 来 处 理 ， 这 种 方式 更 加 节省 内 存 ; 而 JVM 调 用 GC 的 策略 也 有 很 多 种 ， 


但 通常 来 说 ， 我 们 不 需要 关心 这 些 。 


由 于 每 个 Android 应 用 程序 可 使 用 的 内 存 大 小 是 有 限制 的 (一 般 是 16MB) ， 所 以 我 们 在 编码 实现 时 要 特别 注意 内 存 的 使 用 ， 特 别 是 在 遇 到 需要 使 用 大 量 内 存 的 功能 时 。 比 如 之 前 介绍 的 微 博 应 用 实例 


中 ， 在 读 取 图 


另外 ， 我 们 需要 了 解 的 是 ， 虽 然 GC 已 经 帮助 我 们 处 理 了 大 部 分 内 存 回 收 的 工作 ， 但 是 ， 对 于 比较 复杂 的 Android 应 
以 ， 在 开发 完成 之 后 我 们 通常 都 需要 进行 严格 的 测试 来 判断 应 用 是 否 存在 内 


片 时 我 们 就 遇 到 了 类 似 的 问题 ; 因为 Bitmap 对 象 使 用 的 是 应 用 自身 的 堆 内 存 (Heap) ， 所 以 在 处 理 较 大 图 


片 时 就 需要 使 用 略 缩 图 的 方式 ， 处 理 方法 请 参考 7.7.6 节 后 半 部 分 的 内 容 。 


或 者 游戏 来 说， 要 在 开发 过 程 中 完全 避免 内 存 泄露 的 想法 显然 是 过 于 理想 化 了 。 所 


存 泄露 的 问题 ， 所 幸 的 是 Android 开 发 组 件 中 已 经 提供 了 比较 好 用 的 分 析 工具 ， 接 下 来 我 们 就 着 手 进行 学 习 。 


10.2.2 ”如 何 判 断 内 存 泄露 


与 Java 语 言 环境 类 似 ，Android 系 统 框架 也 为 我 们 提供 了 HPROF 工 具 来 监控 内 存 和 CPU 的 使 


存 泄露 报告 。 


MATI. 


情况 。 在 Android 开 发 环境 中 ， 我 们 主要 使 用 Eclipse 的 MAT (Memory Analyzer) 工具 来 获取 准确 的 内 


可 以 在 Help 菜 单 中 的 Install New Software 功 能 界面 中 安装 ， 找 到 Eclipse 更 新 站 点 下 面 的 General Purpose Tools 之 下 的 Memory Analyzer 选 项 ， 选 中 并 进行 安装 即 可 ， 如 图 10-1 所 示 。 如 
果 找 不 到 ， 请 根据 官方 站 点 http://www.eclipse.org/mat/downloads.php 之 上 的 最 新 Update Site 地 址 手动 进行 添加 。 


然后 ， 只 需要 在 DDMS 界 面 的 Devices 选 项 栏 中 选中 需要 进行 内 存 分 析 的 进程 ， 比 如 微 博 应 用 实例 的 进程 一 一 com.app.demos， 然 后 点 击 Dump HPROF File 按 钮 (如 图 10-2 所 示 ) 就 可 以 生成 当前 的 


HPROF 文 件 。 


Available Software 
Check the itens that you wish to install. 


York vith [Indigo - http //düovnload eclipse. org/releases/ indigo 


v Add... 


Find nore software by working with the “Avsilsble Software Sites” preferences. 


(2i [m] General Purpose Tools 
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图 10-1 MATS RH 


图 10-2 Dump HPROF File 按 钮 


在 Eclipse 环境 中 的 ADT 和 MAT 都 能 正常 使 用 的 情况 下 ， 系 统 会 自动 生成 最 终 的 内 存 泄露 报告 (Leak Suspects) ， 如 
hprof-conv.exe 把 .hprof 文 件 转化 成 正确 的 格式 ， 然 后 在 Eclipse 的 Memory Analysis 界 面 中 手动 导入 并 分 析 。 


图 


D 


10-3 所 示 。 当 然 ， 如 果 没 能 


动 生成 的 话 ， 我 们 也 可 以 通过 Android SDK 工 
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10-3 MAT 内 存 泄露 报告 


在 MAT 为 我 们 提供 的 Leak Suspects 中 我 们 可 以 看 到 MAT 帮 助 我 们 分 析 所 得 的 最 占 内 存 的 类 对 象 ， 还 可 以 在 Dominator Tree 中 查找 相关 Package 下 面 可 能 产生 内 存 泄 露 的 所 有 可 疑 类 。 当 然 ， 再 好 用 的 
工具 也 只 能 起 到 辅助 的 作用 ， 要 精确 定位 内 存 泄 露 问题 的 根源 所 在 ， 还 需要 深入 到 具体 的 代码 实现 中 去 ， 因 此 我 们 需要 具备 处 理 一 些 常见 内 存 泄 露 问题 的 经 验 ， 下 节 中 我 们 就 来 学 习 相关 内 容 。 


102.3 ”常见 内 存 泄露 的 处 理 


首先 ， 我 们 需要 知道 Java 中 引起 内 存 泄露 的 根本 原因 是 引用 了 垃圾 对 象 。 简 单 来 说 ， 也 就 是 程序 引用 了 某 些 对 象 ， 但 是 却 从 来 没有 使 用 过 ， 致 使 GC 无 法 正常 回收 ， 最终 导 致 了 内 存 溢 出 的 问题 。 对 于 
Android 来 说 ， 除 了 需要 了 解 Java 语 言 本 身 存 在 的 问题 之 外 ， 还 需要 注意 Android 系 统 自身 的 特点 ， 我 们 将 实施 过 程 中 可 能 出 现 的 一 些 常见 问题 的 处 理 方式 归纳 如 下 。 


1. 程 序 逻 辑 的 内 存 泄露 


一 些 不 好 的 编程 习惯 可 能 在 程序 逻辑 中 造成 内 存 泄露 的 隐 是 


CHI 


， 比 如 在 不 恰当 的 位 置 销毁 对 象 ， 如 代码 清单 10-4 所 示 。 


& 


代码 清单 10-4 


Vector customers = new Vector (100); 

for (int i = 1; i < 100; i++) ( 
Customer customer - new Customer(); 
customers.add (customer); 
customer - null; 


以 上 代码 中 ， 我 们 先 创建 了 一 个 customers 数 组 ， 然 后 循环 加 入 新 建 的 Customer 对 象 ， 虽 然 在 每 次 加 入 之 后 都 将 新 的 Customer 对 象 设置 为 null 了 ， 但 是 实际 上 所 有 的 Customer 对 象 并 没有 被 销毁 ， 因 
为 变量 customers 的 引用 依然 存在 ; 另外 ， 这 些 对 象 都 已 经 无 用 了 ， 但 却 还 被 3 引用， 这样 GC 就 无 能 为 力 了 。 


另外 ， 循 环 引用 也 会 产生 类 似 的 GC 回 收 障碍 ， 比 如 在 类 A 中 引用 了 类 B 的 对 象 ， 而 类 B 中 又 引用 了 类 A 的 对 象 ， 我 们 在 编码 实现 的 时 候 也 要 特别 注意 避免 类 似 的 设计 ， 这 里 就 不 再 举例 说 明了 。 


2 .数据 库 查询 没有 关闭 游标 


对 于 数据 库 游标 这 种 大 型 对 象 来 说 ， 使 用 过 后 必须 关闭 回收 。 当 然 ， 系 统 发 现 这 种 情况 的 时 候 通 常会 抛 出 异常 来 提醒 我 们 ， 虽 然 对 于 Android 应 用 来 说 ， 这 些 异常 并 不 会 直接 导致 系统 崩溃 ， 但 是 我 建 
议 大 家 还 是 要 重视 起 来 ， 如 有 发 现 应 及 时 处 理 ， 否 则 不 仅 有 可 能 造成 内 存 泄露 ， 还 会 影响 应 用 的 运行 速度 。 


3. 合 理 使 用 上 下 文 对 象 (Context) 


上 下 文 对 象 (Context) 是 Android 开 发 中 最 重要 的 内 容 之 一 ， 保 存 了 对 整个 Android 应 用 或 者 当前 Activity 引 用 的 资源 ， 更 多 信息 请 参考 2.5 节 中 的 内 容 。 程 序 逻 辑 中 我 们 可 以 很 方便 地 使 用 Context 上 
下 文 对 象 来 实现 界面 逻辑 ， 但 是 同时 也 要 注意 由 于 Context 上 下 文 对 象 牵 涉 的 资源 引用 非常 多 ， 一 旦 出 现 内 存 泄露 ， 后 果 是 很 严重 的 。 


最 常见 的 Context 上 下 文 对 象 造成 的 内 存 泄露 是 因为 超出 自身 的 生命 周期 而 导致 的 。 比 如 在 一 些 生命 周期 比较 长 的 对 象 中 (如 Service 服 务 或 者 某 些 运行 时 间 比 较 长 的 线程 ) 使 用 了 某 个 Activity 的 
Context 对 象 ， 那 么 当 这 个 Activity 被 销毁 时 ， 该 Context 对 象 就 变 成 了 垃圾 对 象 。 另 外 ， 我 们 还 要 特别 注意 避免 把 Activity 内 的 控件 对 象 声 明 为 静态 ， 这 种 做 法 在 屏幕 旋转 的 时 候 就 可 能 产生 内 存 泄露 。 


总 之 ， 在 使 用 Context 上 下 文 对象 的 时 候 需要 注意 几 点 : 其 一 ， 避 免 让 生命 周期 过 长 的 对 象 引 用 Activity Context， 即 保证 Activity 内 对 象 的 生命 周期 和 自身 是 一 致 的 ， 其 二 ， 在 Activity 类 内 使 用 静态 声 
了 明 的 时 候 要 特别 注意 ， 比 如 控件 对 象 最 好 不 要 是 静态 的 ， 而 内 部 类 则 最 好 是 静态 的 。 另 外 ， 对 于 生命 周期 比较 长 的 对 象 ， 建 议 使 用 Application Context, 


4.Bitmap 对 象 不 使 用 后 未 调用 recycle 方 法 释放 内 存 


Bitmap 对 象 在 不 使 用 时 ， 我 们 应 该 先 调用 recycle 方 法 释放 内 存 ， 然 后 再 将 其 设置 为 null。 虽 然 从 源码 上 看 ， 调 用 recycle 方 法 应 该 能 立即 释放 Bitmap 的 主要 内 存 ， 但 是 实际 测试 结果 显示 它 并 没 能 立即 
释放 内 存 。 


5 .构造 Adapter 时 未 使 用 缓存 的 View 对 象 


这 点 主要 是 针对 列表 控件 (ListView) 来 说 的 。 以 基础 适配器 BaseAdapter 为 例 ， 初 始 状态 下 ListView 会 根据 当前 的 屏幕 布局 从 BaseAdapter 中 实例 化 一 定数 量 的 View 对 象 ， 同 时 将 这 些 View 对 象 缓存 


起 来 。 当 ListView 滚 动 时 ， 不 再 显示 的 列表 项 View 对 象 会 被 回收 ， 上 
项 View 对 象 。 显 然 ， 如 果 我 们 在 每 次 getView 时 不 去 使 用 


实际 上 ， 本 书 微 博 实例 中 有 好 几 处 都 用 到 了 现 


另外 ， 前 面 介绍 Java 代 码 优化 的 时 候 也 涉及 一 


来 构造 新 出 现 的 列表 项 。 这 个 构造 过 程 就 是 由 getView 方 法 完成 的 ， 该 方法 的 第 二 个 参数 “View convertView” 就 是 被 缓存 起 来 的 列表 
缓存 的 convertView 对 象 而 是 每 次 都 创建 新 的 View 对 象 ， 将 使 得 应 用 占用 的 内 存 越 来 越 大 ， 既 没有 效率 又 浪费 资源 。 


表 适 配器 ， 比 如 微 博 列表 界面 中 我 们 使 用 到 的 列表 适配器 类 BlogList (如 代码 清单 7-63 所 示 ) 等 。 


些 内 存 使 用 的 优化 技巧 ， 比 如 合理 使 用 static 和 final 修 饰 符 ， 及 时 地 回收 对 象 ( 将 不 用 的 对 象 设置 为 null) 以 及 尽量 使 用 原生 的 数据 结构 等 。 假 如 我 们 可 以 


把 以 上 的 注意 事项 都 做 好 ， 相 信和 最 终 的 Android 应 


产品 一 定 可 以 远离 内 存 泄露 问题 的 困扰 。 


10.3 优化 Android UI 


前 面 讲 的 都 是 程序 编码 方面 的 优化 工作 ， 接 下 


» 


10.3.1 模板 代码 优化 


Android UI 模板 使 用 XML 语 言 来 实现 ， 语 法 本 身 没有 什么 值得 讲 的 ， 我 们 只 需要 根 


` 不 要 使 用 固定 的 绝对 定位 布局 (AbsoluteLay 


来 介绍 在 Android 应 用 开发 中 与 UI 优化 有 关 的 内 容 。 因 为 UI 模板 开发 也 是 Android 开 发 中 不 可 忽视 的 重要 环节 ， 所 以 UI 模板 优化 也 是 客户 端 优化 的 重要 内 


out) 。 


+ 不 要 使 用 px 单位 ， 统 一 使 用 dip 或 者 dp， 如 果 是 文本 则 使 用 sp。 


“ 所 有 资源 都 要 针对 高 分 辩 率 屏幕 创建 (缩小 
“ 使 用 适当 的 间距 (margin、padding) o 


“ 适当 处 理 屏 幕 方 向 变化 ， 必 要 时 固定 界面 的 


比 放大 好 ) 。 


方向 。 


` 使 用 主题 (Theme) 和 样式 (Style) 来 减少 界面 宛 余 。 


居 需 求 设置 UI 控件 的 不 同属 性 值 即 可 ;但 是 ， 在 实际 使 用 过 程 中 还 是 有 不 少 要 点 需要 我 们 注意 ， 现 总 结 如 下 。 


实际 上 ， 微 博 应 用 实例 中 绝 大 多 数 界 面 模板 都 基本 遵循 了 以 上 的 代码 优化 原则 ， 第 7 章 中 介绍 的 所 有 界面 的 模板 代码 都 是 非常 好 的 例子 ， 大 家 可 以 用 于 参考 ， 加 深 体 会 。 当 然 ， 我 们 也 需要 知道 ， 微 博 应 


10.32 ”关于 布局 优化 


Android 布 局 是 Ul 界 面 设计 中 一 个 非常 重要 的 工具 ， 主 要 负责 界面 框架 布局 的 搭建 ， 最 常 使 用 的 布局 控件 包括 基本 布局 (Framelayout) 、 线 性 布局 (LinearLayout) 、 相 对 布 


的 模板 代码 绝 不 是 完美 的 ， 如 果 大 家 在 学 习 的 同时 还 能 发 现 其 中 存在 的 问题 并 予以 改进 ， 那 么 我 们 就 达到 了 理想 的 学 习 效果 。 


a 


(RelativeLayout) 、 绝 对 布局 (AbsoluteLayout) 以 及 表格 布局 (TableLayout) 等 ， 这 些 布局 控件 的 基本 用 法 请 参考 2.7.2 节 。 


1. 使 用 合适 的 布局 方式 


我 们 知道 ， 相 同 的 界面 可 以 使 用 不 同 的 布局 来 实现 ， 但 是 实现 的 方式 不 同 ， 模 板 解析 的 效率 也 不 同 。 就 这 点 来 说 ， 我 们 需要 注意 两 个 原则 : 其 一 ， 模 板 文件 的 代码 行 数 越 少 ， 解 析 速 度 越 快 ， 其 二 ， 模 


板 布局 谋 套 越 简单 ， 解 析 速 度 也 越 快 。 下 面 我 们 以 


微 博 列表 界面 项 部 的 用 户 信息 的 布 


这 是 一 个 在 应 用 界面 设计 中 经 常用 到 的 典型 布 


代码 清单 10-5 


局 为 例 来 讲解 ， 详 情 请 参考 7.9.2 节 ， 界 面 如 图 10-4 所 示 。 


图 10-4 ” 微 博 列表 界面 顶部 布局 


局 ， 在 7.9.2 节 的 ui_blog.xml 模 板 中 我 们 使 用 了 相对 布 


局 RelativeLayout 来 实现 。 下 面 我 们 将 这 部 分 的 模板 代码 截取 下 来 ， 如 代码 清单 10-5 所 示 。 


<RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"60dip"» 


<ImageView android:id="@+id/app blog image face" 


android:layout width-"50dip" 

android:layout height-"50dip" 

android:layout margin-"5dip" 

android:src-"(drawable/face" 

android:scaleType-"fitXY" 

android:focusable-"false"/» 
<TextView 


android:layout width-"wrap content" 

android:layout height-"wrap content" 
android:layout marginTop-"8dip" 
android:id="@+id/app blog text customer name" 


android:textStyle-"bold" 
android:text-"name" 


android: layout_toRightOf="@+id/app_blog_image_face"/> 


<TextView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 


android 
android:text-"info" 


="@+id/app blog text customer info" 


android:layout toRightOf="@+id/app blog image face" 
android:layout below-"84id/app blog text customer name"/» 


«Button 
android:layout width-"80dip" 
android:layout height-"32dip" 


android:background="@drawable/button_1" 


android:id="@+id/app blog btn addfans" 

android:text="@string/btn addfans" 

android:layout alignParentRight-"true" 

android:layout alignParentBottom-"true" 

android:layout marginRight-"8dip" 

android:layout marginBottom-"5dip"/» 
«/RelativeLayout» B 


我 们 可 以 看 到 ， 使 用 RelativeLayout 来 实现 ， 布 局 谋 套 仅 有 一 层 ， 代 码 也 相对 比较 简单 ， 大 家 可 以 想象 一 下 如 果 使 用 线性 布局 LinearLayout 来 实现 需要 多 少 层 的 布局 嵌 套 ， 需 要 增加 多 少 行 代 码 。 从 这 
点 我 们 可 以 看 出 ， 在 以 上 这 种 情况 下 ， 使 用 RelativeLayout 实 现 比 起 使 用 LinearLayout 要 好 很 多 。 当 然 ， 在 一 些 布局 比较 简单 的 界面 中 ， 比 如 完全 水 平 或 者 垂直 排 布 的 情况 下 ， 使 用 RelativeLayout 就 没有 
必要 了 。 


3 外， 在 使 用 RelativeLayout 时 还 需要 注意 一 点 ， 由 于 该 布局 是 通过 内 部 控件 的 相对 位 置 来 决定 排 布 方式 的 ， 如 果 其 中 的 某 些 控件 发 生变 化 (比如 隐藏 起 来 ) ， 则 会 影响 到 与 其 关联 的 控件 。 好 在 
Android 为 我 们 提供 了 属性 alignWithParentlfMissing 来 解决 这 个 问题 ， 当 出 现 上 述 情况 时 ， 控 件 可 以 根据 alignWithParentlfMissing 的 值 来 判断 是 否 需要 和 上 一 层 的 控件 对 齐 。 


2. 学 会 复 用 模板 的 资源 


与 程序 开发 一 样 ， 模 板 开 发 也 强调 复 用 性 ， 简 单 来 说 就 是 把 界面 中 公用 的 模板 提取 出 来 ， 提 供给 其 他 界面 模板 来 调用 。 良 好 的 复 用 型 不 仅 可 以 简化 应 用 模板 的 代码 ， 让 开发 和 维护 工作 更 方便 ， 还 可 以 
来 优化 模板 的 层次 结构 ， 提 升 应 用 的 运行 效率 。 


复 用 模板 资源 必须 用 到 <merge/> 和 <include/> 标 签 ， 前 者 作为 XML 模板 的 根 节点 用 于 标识 复 用 模板 ， 后 者 则 用 于 在 复 用 模板 中 包含 其 他 的 模板 。 实 际 上 ， 我 们 在 7.2.2 节 中 已 经 详细 说 明了 以 上 两 个 
标签 的 用 法 ， 还 使 用 了 微 博 应 用 的 主 界面 ( 即 微 博 列表 界面 ) 作为 其 使 用 范例 ， 模 板 代码 可 以 参考 代码 清单 7-23， 其 中 就 使 用 <merge/> 和 <include/> 标 签 来 包含 微 博 界面 的 上 、 下 两 个 部 分 ( 即 
main_top.xml 和 main_tab.xml) 以 及 通用 的 界面 组 件 模板 ( 即 main_layout.xml) 。 大 家 可 以 回顾 一 下 ， 体 会 模板 复 用 的 思路 和 用 法 。 


另外 ， 在 模板 复 用 时 还 要 注意 一 点 ， 那 就 是 不 要 因为 错误 的 包含 方式 造成 不 必要 的 资源 浪费 ， 如 在 模板 布局 中 出 现 “ 宛 余 节点 ”。 下 面 我 们 举例 说 明 ， 比 如 项 目 中 有 个 test_frame.xml 模 板 ， 如 代码 清 
单 10-6 所 示 。 


代码 清单 10-6 


<?xml version-"1.0" encoding-"utf-8"?» 
"http: //schemas .android.com/apk/res/android" 
ill parent" 


<TextView 
android: text="big" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:textSize-"50pt"/» 

<TextView 
android: text="middle" 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize-"20pt"/» 

<TextView 
android: text="small" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize="10pt"/> ^ 

</FrameLayout> 


test frame.xml 模 板 的 代码 很 简单 ， 就 是 在 基本 布局 (FrameLayout) 中 放置 了 三 个 TextView， 运 行 效果 如 图 10-5 所 示 。 


图 10-5 test_frame.xmli& ££ 2 RK 


然后 ， 我 们 需要 在 另 一 个 模板 test merge.xml 中 包含 test_ frame.xml 模 板 的 内 容 ， 因 此 我 们 使 用 <merge/> 和 <include/> 标 签 来 实现 ， 见 代码 清单 10-7。 
代码 清单 10-7 


<?xml version-"1.0" encoding-"utf-8"?» 

«merge xmlns:androide"http://schemas.android.com/apk/res/android"» 
«include layout-"8layout/test frame" /> 

«/merge» 


10-6 所 示 。 我 们 可 以 看 到 test_merge.xml 界 面 的 模板 结构 有 4 层 ， 而 中 间 两 层 都 是 FrameLayout， 这 就 是 


运行 test_merge.xml 模 板 界面 ， 并 使 用 Hierarchy Viewer 工 具 查 看 该 界面 的 UI 结 构 视 图 ， 如 
一 种 明显 的 “ 宛 余 节点 ”。 


D 


小 贴 士 : Hierarchy Viewer LÆ Android SDK 为 我 们 提供 的 用 来 查看 模板 UI 结 构 视图 的 工具 ， 详 细 的 使 用 方法 可 参考 10.3.3 节 中 内 容 。 
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我 们 知道 ， 通 常 布局 的 层次 越 多 ， 模 板 解析 起 来 就 越 慢 ， 比 较 正 确 的 思路 是 把 <merge/> 和 <include/> 标 签 当做 一 个 临时 的 布局 ， 最 终 模板 组 合 的 时 候 应 该 把 这 些 临 时 布局 剔除 。 所 以 ， 我 们 对 
test frame.xml 模 板 进行 如 下 修改 ， 如 代码 清单 10-8 所 示 。 


代码 清单 10-8 


<?xml version-"1.0" encoding-"utf-8"?» 
«merge xmlns:android="http: //schemas.android.com/apk/res/android"> 
<TextView 
android: text="big" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:textSize-"50pt"/» 


<TextView 
android: text="middle" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:textSize-"20pt"/» 


«TextView 
android:text-"small" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android:textSize-"l0pt"/» 
</merge> 


以 上 修改 简单 来 说 就 是 把 外 层 的 <FrameLayout/> 标 签 换 成 了 <merge/> 标 签 ， 接 下 来 重新 观察 UlI 结 构 视图 ， 我 们 会 发 现 此 时 test_merge.xml 界 面 的 模板 结构 已 经 被 简化 到 了 3 层 ， 原 先 两 个 
FrameLayout 也 变 成 了 一 个 ， 如 图 10-7 所 示 。 
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限于 篇 幅 ， 关 于 Android UI 布局 优化 的 内 容 到 此 为 止 ， 更 多 优化 技巧 需要 大 家 在 实际 应 用 的 过 程 中 不 断 总 结 。 


大 限度 地 复 用 模板 资源 。 当 然 ， 只 有 做 到 了 以 上 两 点 ， 写 出 来 的 模板 代码 才 可 能 是 比较 合格 的 。 


] 号 om Petrar 
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在 实现 模板 的 过 程 中 ， 一 定 要 注意 以 下 两 点 : 其 一 ， 尽 量 使 用 合适 的 布局 方式 ; 其 二 ， 最 


前 面 在 介绍 布局 优化 时 已 经 提 到 过 Hierarchy Viewer 工 具 的 使 用 ,我 们 也 了 解 到 该 工具 是 用 来 查看 模板 Ul 结构 视图 的 。Hierarchy Viewer 工 具 的 


中 的 hierarchyviewer.bat 文 件 就 可 以 了 ， 不 过 需要 注意 的 是 该 工具 需要 和 模拟 器 配合 运行 。 比 如 在 模拟 器 中 运行 微 博 应 


com.app.demos 进 程 ， 然 后 点 击 上 方 的 “Load View Hierarchy” 按 钮 就 可 以 看 到 正在 运行 的 UI 界 


[EH] 


的 结构 视图 


了 (参考 图 


10-6 或 


图 10-7) 。 


F 


的 时 候 ， 打 开 Hierarchy Viewer 就 会 看 到 图 


法 比较 简单 ， 只 需要 运行 Android SDK 下 面 tools 目 录 


10-8 所 示 的 树 型 列表 ， 我 们 选中 相应 的 


Hierarchy Viewer 


Eile Devices Halo 


-$ Load Vier Hierarchy || “A Inspect Screenshot 


一 g esulator-5554 
: Focused Tindow? 
Xepgae d 
Statush ar 


SistusB arExpanded 

TrackincViev 

cot. app. denos’ cos. app. demos. text 

com. android. lamcher/ com. android. leuncher2. Launcher 
cot. android internal. cervice wallpaper. InageNall paper 


410-8 Hierarchy Viewer Ri 


接 下 来 ， 我 们 就 可 以 根据 UI 结 构 视 图 来 分 析 对 应 模板 需要 优化 的 地 方 。 当 然 ，Android SDK 还 为 我 们 提供 了 另外 一 个 模板 优化 的 工具 ， 即 layoutopt 工 具 。 和 Hierarchy Viewer 工 具 不 同 的 
是 ，Layoutopt 工 具 会 帮助 我 们 分 析 XML 模 板 文件 的 代码 ， 并 且 把 分 析出 来 的 优化 建议 告诉 我 们 。 其 命令 行 工具 layoutopt.bat 和 hierarchyviewer.bat 在 同一 个 目录 下 ， 使 用 时 只 需要 在 该 命令 行 后 面 接 上 模 
板 文件 的 地 址 就 可 以 了 。 比 如 ， 我 们 可 以 使 用 layoutopt 来 分 析 微 博 列 表 界面 的 模板 ， 也 就 是 ui_index.xml， 分 析 结果 如 图 10-9 所 示 。 


C:XWINDOWSXsystem32Xcnd. exe 


D=Nandroid\tools>layoutopt.bat e:*eclipse workspace \androidphp\appMWenos e lient 
res \layout \wi_index.xml 


c = Nec lipse workspace sandroidphp app demos wc Lient \res Nlayout Nui_index.xml 


13:24 Use an android:layout height of @dip instead of wrap content for b 
etter performance 


ID: *«android*tools»? 


[10-9 layoutopt 工 具 的 分 析 结 果 


我 们 可 以 看 到 layoutopt 给 出 优化 建议 ， 我 们 可 以 参考 并 进行 优化 。 此 外 ， 使 用 layoutopt 工 具 的 时 候 我 们 还 要 注意 的 是 ，layoutopt 后 面 必 须 跟 着 模板 文件 的 完整 目录 名 ， 即 使 已 经 在 模板 目录 下 ， 否 
则 layoutopt 工 具 会 提示 找 不 到 文件 。 


Bit, Android UI 优 化 部 分 的 内 容 已 经 基本 介绍 完毕 。 学 习 理 解 之 后 ， 大 家 应 该 会 对 Android 应 用 开发 中 的 模板 编写 有 了 更 深 的 认识 。 最 后 ， 再 补充 强调 一 点 ， 由 于 XML 模板 的 解析 过 程 是 比较 耗费 资 
源 的 ， 而 且 在 多 线程 的 环境 中 读 取 模板 文件 还 要 考虑 到 并 发 的 问题 ， 所 以 再 好 的 XML 模板 布局 也 比 不 上 使 用 java 语言 来 进行 布局 。 在 可 能 的 情况 下 ， 大 家 可 以 尝试 直接 使 用 java 代码 来 构造 Ul 界 面 ， 也 许 会 
有 意外 的 收获 。 


104 其 他 优化 


对 于 Android 应 用 来 说 ， 程 序 虽然 是 绝对 的 核心 所 在 ， 但 是 资源 文件 往往 才 是 最 占 内 存 空间 ， 也 是 最 费 系 统 资源 的 部 分 ， 而 图 片 又 是 Android 应 用 中 最 常见 的 一 种 资源 文件 ， 所 以 下 面 我们 将 首先 介绍 与 
图 片 优化 有 关 的 内 容 。 最 后 ， 我 们 还 将 介绍 Android 应 用 的 打包 过 程 ， 以 及 该 过 程 中 涉及 的 APK 包 的 优化 工作 。 


10.4.1 优化 图 片 


在 Android 系 统 中 ， 昌 然 位 图 类 库 BitmapFactory 的 功能 还 是 比较 完善 的 ， 但 是 在 处 理 大 图 时 却 不 是 那么 令 人 满意 。 特 别 对 于 一 些 比 较 复杂 的 应 用 来 说 ， 大 量 资源 文件 的 处 理 往往 会 占用 绝 大 部 分 的 系 


统 资源 。 因 此 我 们 在 开发 过 程 中 还 需要 注意 让 美工 人 员 对 图 片 本 身 进行 优化 ， 尽 可 能 降低 应 用 程序 资源 对 图 片 处 理 的 开销 。 


1. 图 片 压缩 策略 


压缩 图 片 需要 注意 两 方面 的 内 容 。 首 先 ， 我 们 需要 使 用 合适 的 图 片 大 小 ， 由 于 Android 移 动 设备 的 型 号 非常 多 ， 屏 幕 的 大 小 、 尺 寸 也 不 尽 相 同 。 因 此 ， 如 何 让 同一 张 图 片 在 不 同 大 小 的 屏幕 上 合理 地 显 
示 对 Android 应 用 或 者 游戏 来 说 是 非常 重要 的 。 比 较 好 的 做 法 是 ， 先 选择 一 个 最 常见 的 设备 屏幕 进行 开发 ， 然 后 在 可 以 接受 的 范围 之 内 让 界面 做 到 自 适 应 。 当 然 ， 使 用 XML 模板 实现 是 比较 容易 办 到 的 ， 但 
是 对 于 游戏 应 用 来 说 就 比较 难 了 ， 我 们 需要 通过 界面 画布 的 getWidth 和 getHeight 方 法 获取 当前 设备 屏幕 的 尺寸 来 动态 计算 图 片 的 缩放 比例 。 


另外 ， 减 少 图 片 的 颜色 、 色 深 也 可 以 减少 图 片 的 大 小 ， 比 如 色 深 减少 到 原来 的 一 半 ， 图 片 容量 就 可 以 减少 到 原来 的 三 分 之 一 。 所 以 在 准备 图 片 资源 时 ， 需 要 和 美工 人 员 一 起 商定 ， 如 何在 界面 效果 可 以 
接受 的 范围 内 ， 尽 量 减少 图 片 的 颜色 数 。 


当然 ， 对 于 游戏 应 用 来 说 还 有 一 种 做 法 ， 就 是 把 多 张 图 片 集成 到 一 张 图 片上 ， 比 如 我 们 把 10 张 图 片 集成 到 一 张 图 片 中 ， 这 张大 图 的 容量 会 比 10 张 图 片 容量 的 总 和 小 很 多 ， 这 是 因为 我 们 省 去 了 每 张 图 片 
的 文件 头 、 公 用 数据 块 等 信息 。 


2. 压 缩 工具 (PNGOUT) 


在 Android 应 用 中 我 们 最 常 使 用 的 图 片 格式 就 是 PNG， 所 以 我 们 可 以 寻找 一 些 PNG 图 片 的 压缩 工具 。PNGOUT 就 是 一 款 非 常 优秀 的 PNG 图 片 压缩 工具 ， 该 工具 既 提 供 了 强大 的 命令 行 模式 ， 支 持 多 种 
色彩 模式 以 及 多 种 优化 策略 ; 还 支持 方便 的 Windows 对 话 框 界 面 ， 让 美工 人 员 们 操作 起 来 更 简单 。 更 多 信息 请 参考 官网 : http://www.advsys.net/ken/util/pngout.htm。 


1042 优化 APK 包 


我 们 知道 ，Android 应 用 最 终 会 被 打包 成 APK 包 (AndroidPackage 的 缩写 ) ， 才 能 在 Android 设 备 上 安装 。 在 Eclipse 开 发 工具 中 只 需要 使 用 右键 菜单 “Android Tools” 之 中 的 “Export 
Singed/Unsigned Application Package” 选 项 进行 导出 即 可 ，Android 运 行 环境 会 为 我 们 自动 完成 打包 的 整个 过 程 ， 图 10-10 中 描绘 了 标准 的 Android 应 用 打包 过 程 。 


应 用 配置 文件 编译 后 的 包 Meta 信息 
AndroidManifest.xml AndroidManifest.xml 


Compiler 


Apk 


Builder 


R*.class 


图 10-10 “标准 的 Android 应 用 打包 过 程 


从 Android 打 包 过 程 的 角度 来 说 ，Android 应 用 的 代码 可 分 为 三 大 部 分 ， 应 用 配置 文件 (AndroidManifest.xml) 、Java 源 代码 以 及 原始 资源 文件 。 在 打包 过 程 中 ， 应 用 配置 文件 和 原始 资源 文件 将 会 使 
用 aapt 工 具 进行 编译 处 理 ， 而 Java 源 代码 文件 则 会 依次 使 用 java 编译 器 和 dx 编译 工具 转化 成 Dex 字 节 码 文件 ， 然 后 使 用 ApkBuilder 工 具 打包 形成 APK 包 文件 ， 最 后 使 用 签名 工具 (keytool 和 jarsigner) 进 
行 包 签名 并 得 到 最 终 的 APK 文 件 ， 也 就 是 应 用 安装 包 。 


小 贴 士 : aapt (Android Asset Packaging Tool) 工具 可 用 于 创建 、 删 除 或 者 查看 ZIP 兼 容 格式 (zip. jar. apk) 的 打包 文件 ， 还 可 以 把 资源 编译 成 二 进 制 资源 包 。 


上 述 打包 过 程 中 ， 前 面 的 几 个 步骤 我 们 不 需要 关心 ，Android 运 行 环境 会 自动 帮助 我 们 完成 。 需 要 注意 的 是 最 后 使 用 keytool 和 jarsigner 工 具 进 行 签名 的 过 程 ， 因 为 这 部 分 内 容 可 能 需要 我 们 手动 进行 ， 
另外 还 可 能 涉及 一 些 与 Android 应 用 优化 相关 的 知识 。 


104.3 ”使 用 keytool 和 jarsigner 签 名 


1. 对 APK 安 装 包 签 名 的 主要 原因 


(1) 保证 信息 的 安全 性 和 完整 性 


签名 过 程 会 对 包 中 的 每 个 文件 都 进行 处 理 ， 进 而 生成 唯一 的 签名 key， 并 以 此 来 确保 每 个 安装 包 信 息 的 完整 性 。 另 外 ， 签 名 不 同 的 包 是 不 可 以 被 覆盖 安装 的 ， 这 样 可 以 防止 已 安装 的 应 用 被 第 三 方 覆盖 或 
者 替换 掉 ， 因 此 我 们 可 以 认为 签名 过 的 包 是 安全 的 。 


(2) 发 送 者 的 身份 认证 ， 防 止 交易 中 的 抵赖 情况 


签名 信息 中 也 包含 了 对 开发 者 身份 的 标识 ， 这 样 就 可 以 防止 在 交易 中 发 生 抵赖 情况 。 这 也 是 许多 Android 市 场 对 软件 开发 者 的 要 求 之 一 。 


我 们 可 以 通过 Eclipse 开发 工具 提供 的 签名 向 导 ( 即 右键 菜单 “Android Tools” 之 中 的 “Export Singed Application Package” 选 项 ) 来 完成 签名 的 过 程 ， 由 于 全 过 程 只 要 按照 向 导 的 提示 来 操作 即 


E 
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非 对 称 加 密 算法 ) 。keytool 工 具 的 常用 命令 或 选项 如 下 所 示 。 


Java 系 统 提供 的 keytool 和 jarsigner 工 具 来 手动 签名 ， 由 于 涉及 Java 包 签名 的 原理 和 用 法 ， 这 里 本 


点 介绍 一 下 。 


首先 ，keytool 是 Java 为 我 们 提供 的 数据 证 书 管理 工具 ，keytool 工 具 可 以 将 密 钥 (key) 和 证 书 (certificates) 保存 到 一 个 称 为 密 钥 库 (keystore) 的 文件 中 ， 在 密 钥 库 里 一 般 包 含 两 种 数据 : 密 钥 实 
体 (key entity) 和 密 钥 (secret key) ， 又 或 者 是 私 铀 和 配对 公 钥 (K 


“ -genkey: 在 用 户主 目录 中 创建 一 个 默认 文件 “keystore”， 还 会 产生 一 个 mykey 的 别名 ，mykey 中 包含 用 户 的 公 钥 、 私 钥 和 证 书 〈 在 没有 指定 生成 位 置 的 情况 下 ，keystore 会 存在 用 户 系 统 默认 目录 


中 ， 如 : 对 于 window xp 系统 ， 会 生成 在 系统 的 C: \Documents and Settings\UserName\ 目 录 中 ， 文 件 名 为 “.keystore”) 。 


--alias: 指定 证 书 的 别名 。 


: -keystore: 指定 密 钥 库 的 名 称 。 


- -keyalg: 指定 密 钥 的 算法 (RSA 或 DSA， 默 认 采 用 DSA) 。 


: validity: 指定 创建 的 证 书 有 效 期 多 少 天 。 
- -keysize: 指定 密 钥 长 度 。 


“ -keypass: 指定 别名 条 目的 密码 〈 私 钥 的 密码 ) o 


'-Storepass: 指定 密 钥 库 的 密码 〈 获 取 密 钥 库 信 息 的 密码 ) 。 


:-dname: 指定 证 书 拥有 者 信息 。 
:-list: 显示 密 钥 库 中 的 证 书信 息 ( 需 指定 -keystore) o 
Vi 显示 密 钥 库 中 的 证 书 详细 信息 。 


“ -file: 参数 指定 导出 文件 的 文件 名 。 


:-export: 将 别名 指定 的 证 书 导 出 到 文件 〔( 需 指定 -keystote 与 -alias) 。 


--delete: 删除 密 钥 库 中 某 条 目 〈 需 指定 -keystote 与 -alias) o 


--printcert: 查看 导出 的 证 书信 息 ( 需 指定 -flle) o 


: -keypasswd: 修改 密 钥 库 中 指定 条 目的 口令 〈 需 指定 -Keystore 与 -alias) 。 


- -Storepasswd: 修改 密 钥 库 的 口令 ( 需 指 定 -keystore) o 


--import: 将 已 签名 数字 证 书 导 入 密 钥 库 ( 需 指定 -keystore 与 -alias) o 


“ 为 Java 归 档 文件 (JAR) 签名 。 
: 校 验 已 签名 的 JAR 文 件 的 签名 和 完整 性 。 


2. 对 原始 的 APK 包 进行 签名 的 具体 步骤 


其 次 ，jarsigner 是 Java 环 境 提供 的 一 种 签名 工具 。 此 工具 有 以 下 两 个 作用 。 


下 面 我 们 还 将 以 微 博 应 用 为 例 ， 对 其 原始 的 APK 包 app-demos-client.apk 进 行 签名 ， 具 体 步骤 如 下 。 


(1) 签名 前 的 准备 工作 


由 于 keytool 和 和 jarsigner 都 是 JDK 环 境 中 的 工具 ， 所 以 我 们 可 以 把 JDK 的 bin 目 录 加 入 系统 的 PATH 路 径 中 以 方便 操作 。 然 后 ， 我 们 导出 一 个 未 签名 的 包 ， 并 使 用 “jarsigner-verify” 


经 签名 。 当 然 ， 此 时 返回 的 肯定 是 未 签名 的 提示 信息 ， 命 令 行 和 运行 结果 如 图 10-11 所 示 。 


c* C:AXAWINDOWSAVsystem32Acmd. exe 


A, 
D 


命令 来 验证 包 是 否 已 


(2) 使 用 keytool 生 成 公私 钥 和 证 书 


图 10-11 


使 用 jarsigner 工 具 


接着 ， 我 们 需要 使 用 keytool 工 具 生 成 用 户 的 公私 铀 和 证 书信 息 ， 我 们 传 入 以 下 信息 : 使 用 RSA 加 密 、 有 效 期 365 天 、 别 名 james、 别 名 密码 123546、 签 名 文件 app-demo-client.key、 签 名 密码 


123546， 命 令 行 和 运行 结果 如 图 10-12 所 示 。 


cx C: AWINDOWSAsystenm32VXcnd. exe 


tore app-demos-client.key -storepass 123456 -dname 
sh, C-cn" 


图 10-12 使 用 keytool 工 具 


"CN-janes, OU-, O-, 


命令 运行 之 后 ， 就 会 在 当前 目录 下 生成 app-demos-client.key 文 件 ， 这 个 keystore 文 件 就 是 我 们 需要 的 公私 铀 和 证 书 文件 。 另 外 ， 这 里 也 顺便 解释 一 下 指定 证 书 拥 有 者 信息 参数 ， 也 就 是 “- 
dname" 参数 的 用 法 : CN= 名 字 与 姓氏 ，OU= 组 织 单位 名 称 ，O= 组 织 名 称 ，L= 城 市 或 区 域名 称 ，ST= 州 或 省 份 名 称 ，C= 单 位 的 两 字母 国家 代码 。 


我 们 可 以 通过 keytool 工 具 提取 keystore 文 件 中 的 签名 信 行 和 运行 结果 如 图 10-13 所 示 。 如 果 发 现 信息 不 对 ， 则 需要 重新 生成 该 文件 。 
(3) 使 用 arsigner 进 行 签名 


接 下 来 ， 就 是 使 用 jarsigner 工 具 对 APK 包 进行 签名 了 ， 为 了 和 未 签名 的 APK 包 区 分 开 ， 我 们 把 签名 后 的 APK 包 保存 为 app-demos-client-signed.apk。 另 外 ， 由 于 之 前 生成 keystore 文 件 时 我 们 设置 了 
密码 ， 所 以 在 签名 时 需要 我 们 手动 输入 。 命 令 行 和 运行 结果 如 图 10-14 所 示 ， 我 们 可 以 看 到 jarsigner 工 具 会 自动 为 APK 包 中 的 所 有 文件 进行 签名 。 


(4) 验证 签名 是 否 成 功 


最 后 ， 验 证 签名 是 否 成 功 。 再 次 使 用 “jarsigner-verify” 命 令 行 进行 验证 ， 运 行 结果 如 图 10-15 所 示 。 若 返回 “jar 已 验证 ” 则 表示 签名 成 功 。 


c* C:\WINDOYS\srstenmi2\cnad. exe - 口 |x| 


D:N2>2keutool -list -u -keystore app-demos-client.keu -storepass 123456 


Keystore 类 型 |， JKS 
eystore 棍 殿 者 ， SUN 


您 的 keystore 包含 1 fap 


Era james 
aA B5 2012-6-29 
项 类 型 : PrivateKeyEntry 


=, L-pd. ST=sh, C-cn 
3 :CN=james, =, L=pd, ST-sh, C=cn 
ee :4fed@5h6 
月 效 期 : Fri Jun 29 89:32:38 CST 2012 至 Sat Jun 29 89:32:38 CST 2813 
pig. 
MDS :E4:08:FB:41:B9:83:04:E5 :04:10:60: F2:52: 70 : 1F : 7E 
$H01:C2:E7:81:980:C4:5D:50:50:66:4E:F6:13:608:05:24:70:C7:53:06:91 
等 名 算法 名 称 :SHhtuithRsn 
版 本 : 3 


图 10-13 ”keytool 运行 结果 


cx C:\¥INDOYS\systen32\cnad. exe 


c= iy rook apk app-demos-client.apk james 
CMS 密 钥 库 的 口令 245018: 

META—INF/MANI FEST .MF 
META—INF/JAMES .SF 
META—INF/JAMES .RSA 
res/drawable/arrow_1.png 
res/dravable/blog 1.9.png 
res/drawable/blog 2.9.png 
res/drawable/body 1.9.png 
res/drawvable/bodu 2.9.png 
res/dravable/button 1.png 
res/drawable/button 2.ypng 
res/drawable/close s.png 
res/drawable/close t.png 


ri 
: Ded 


FEE EHE EE EE 
FHRIRIRIHIFHHIRI 


IHTE 


图 10-14 jarsignet 运 行 结果 


cx C:\WINDOWS\syst en32\cad. exe 


图 10-15 ”验证 签名 是 否 成 功 


Android SDK 为 我 们 提供 了 zipalign 工 具 (在 SDK 的 tools 目 录 里 ) ， 用 于 对 打包 的 应 用 程序 进行 优化 。 在 你 的 应 用 程序 上 运行 zipalign， 使 得 在 运行 时 Android 与 应 用 程序 间 的 交互 更 有 效率 。 这 种 方式 
能 够 让 应 用 程序 和 整个 系统 运行 得 更 快 ， 我 们 强烈 推荐 在 新 的 和 已 经 发 布 的 程序 上 使 用 zipalign 工 具 来 得 到 优化 后 的 版 本 ， 即 使 你 的 程序 是 在 老 版 本 的 Android 平 台 下 开发 的 。 


由 于 Android 中 每 个 应 用 程序 中 储存 的 数据 文件 都 会 被 多 个 进程 访问 ， 例 如 manifest 文 件 、 应 用 图 标 ， 以 及 应 用 程序 自身 用 到 资源 文件 等 ， 而 只 有 当 资 源 文 件 通过 内 存 映射 对 齐 到 4 字 节 边界 时 (即使 用 
zipalign 工 具 优化 过 ) ， 访 问 资源 文件 的 代码 才 是 有 效率 的 ; 相反 ， 如 果 资 源 本 身 没 有 进行 对 齐 处 理 〈 即 未 使 用 zipalign 工 具 进 行 优化 ) ， 系 统 就 必须 显 式 地 读 取 它们 ， 这 个 过 程 将 会 比较 缓慢 且 会 花费 额外 
的 内 存 。 更 糟 的 情况 是 ， 安 装 一 些 未 优化 的 应 用 程序 会 增加 系统 内 存 压 力 ， 并 造成 系统 反复 地 启动 和 杀 死 进程 ， 最 终 用 户 会 放弃 使 用 如 此 慢 又 耗 电 的 设备 。 


zipalign 工 具 的 用 法 比较 简单 ， 下 面 我 们 用 它 对 前 面 签名 过 的 微 博 应 用 的 APK 包 (Blapp-demos-client-signed.apk) 进行 优化 ， 生 成 最 终 发 布 版 APK 包 app-demos-client-final.apk。 命 令 行 和 运行 结 
果 如 图 10-16 所 示 。 


c^ C:\ WINDOWS \systemi2\cud. exe 


D2\>zipalign -v 4 app-demos-client-signed.apk app-demos-client-final.apk 
Nerifying alignnent of app-demos-client-final.apk 445... 
58 META-INF/MANIFEST.MNF «OK - compressed» 
2681 METR-INF/JAMES.SF 《OK - compressed? 
4248 META-INF/JAMES .RSA «OK — compressed? 
4932 res/dravable/arrou 1.png COK? 
5196 res/dravable/blog 1.9.»ng COK? 
6528 res/drauable/blog 2.9.png <OK> 
8872 res/drauable/body 1.9.png «OK» 
8664 res/dravahle/hody 2.9 png COK> 
9816 res/dravable/button 1.png <OK>) 
18596 res/dravable/button 2.png COK> 
11352 res/dravuable^/close s.png COK) 
12676 res/drawable/close_t.png (OK> 


10-16 ”zipalign 优 化 结果 


至 此 ，Android 程 序 优化 的 内 容 已 经 基本 介绍 完毕 ， 微 博 应 用 的 最 终 发 布 版 APK 包 也 已 经 完成 ， 我 们 可 以 在 Android 设 备 上 安装 运行 ， 享 受 最 后 的 成 果 了 。 相 信 在 经 过 了 多 重 的 优化 之 后 ， 应 用 的 质量 应 
该 会 让 我 们 满意 。 


本 章 内 容 比较 全 面 地 介绍 了 Android 客 户 端 开 发 过 程 中 各 个 方面 的 优化 。 首 先 ， 重 点 介绍 了 与 Android 编 码 有 关 的 优化 ， 以 及 一 些 与 客户 端 缓存 相关 的 技巧 ; 其 次 ， 重 点 讨论 了 与 客户 端 内 存 泄露 有 关 的 
AS; 再 次 ， 介 绍 了 与 Android UI 布局 以 及 模板 代码 有 关 的 优化 内 容 ， 另 外 介绍 了 Hierarchy Viewer 工 具 的 使 用 技巧 ; 最 后 ， 介 绍 了 Android 应 用 发 布 和 签名 的 过 程 ， 以 及 期 间 涉 及 的 与 优化 相关 的 内 容 。 


我 们 已 经 学 习 了 如 何 使 用 Android 系 统 和 PHP 语 言 进行 移动 互联 网 应 用 开发 的 主要 内 容 ， 同 时 也 动手 完成 了 一 个 完整 的 移动 互联 网 应 用 一 一 微 博 应 用 ， 包 括 PHP 服 务 端 接口 和 Android 客 户 端 应 用 的 开 
发 ， 系 统 学 习 了 从 前 期 的 产品 设计 、 架 构 设计 到 程序 开发 ， 以 及 随后 的 程序 优化 和 最 后 的 打包 发 布 一 系列 完整 的 项 目 流程 ， 至 此 大 家 应 该 对 Android 移 动 互 联网 应 用 的 开发 过 程 相当 熟悉 了 。 


接 下 来 ， 我 们 将 要 介绍 Android 开 发 中 更 加 “高 级 ”的 内 容 ， 包 括 Android 应 用 开发 中 比较 有 特色 的 功能 、Android NDK 的 开发 以 及 Android 游 戏 开发 的 相关 内 容 ， 相 信 通 过 学 习 这 些 内 容 ， 大 家 会 对 
Android 开 发 有 更 深入 上 且 全 面 的 认识 。 


Anare 


Android 系 统 之 所 以 优秀 ， 不 仅 是 因为 Android 系 统 为 我 们 提供 了 丰富 的 UI 控 件 和 强大 的 SDK 开 发 包 ， 还 因为 Android 系 统 提供 了 许多 颇具 特色 的 功能 ， 比 如 基于 地 理 位 置 的 LBS 功 能 、 传 感 器 系统 、 多 
媒体 功能 以 及 使 用 摄像 头 进行 拍照 和 录像 等 。 通 过 对 本 章 知识 的 学 习 ， 我 们 将 对 Android 系 统 有 一 个 更 深入 的 了 解 ， 另 外 可 以 利用 这 些 特色 功能 开发 出 更 多 有 创意 的 Android 应 用 。 


11.1 使 用 Google Map API 


Google Map 是 Google 公 司 提供 的 电子 地 图 服务 ， 其 核心 的 业务 是 为 用 户 提供 强大 的 地 图 展示 和 查询 功能 以 及 丰富 的 城市 地 图 和 交通 信息 等 ， 基 于 Google Map 我 们 可 以 完成 许多 非常 酷 的 应 用 ， 比 如 
计算 路 线 、 模 拟 驾驶 等 。 


Google Map 是 Google 公 司 最 成 功 的 产品 之 一 ， 对 于 系 出 同门 的 Android 系 统 来 说 ， 当 然 也 是 必 不 可 少 的 特色 功能 之 一 。 对 于 开发 者 来 说 ， 在 Android 平 台中 使 用 Google Map 提 供 的 API 进 行 开发 是 非 
常 方便 的 。 下 面 我 们 就 来 创建 一 个 基于 Google Map API 的 Android 地 图 应 用 。 具 体 实施 步骤 如 下 。 


1. 申 请 Google Map API Key 


想 要 使 用 Google Map APl 必 须 先 申请 一 个 开发 用 的 API Key， 由 于 该 API Key 是 和 Google 账 号 绑 定 的 ， 所 以 在 此 之 前 我 们 还 需要 到 Google 注 册 一 个 Google 账 号 (Gmail 账号 也 是 可 以 的 ) 。 实 际 
上 ，Google Map API Key 是 与 Android SDK 证 书 相对 应 的 ， 因 此 我 们 需要 先 得 到 本 地 Android SDK 的 指纹 信息 。 


首先 ， 我 们 找到 当前 用 户 目录 下 的 debug.keystore 文 件 ，Windows 中 的 一 般 路 径 为 C: \Documents and Settings\ 当 前 用 户 \.android\debug.keystore，Linux 或 者 Mac OS 中 则 是 /home/ 当 前 用 户 
名 /.android/debug.keystore。 然 后 ， 使 用 keytool 工 具 获 得 证 书 文件 的 指纹 MD5 值 ， 此 过 程 中 如 果 需 要 输入 密码 ， 我 们 可 输入 默认 密码 android， 结 果 如 图 11-1 所 示 。 


cx C: XAWINDOWSXsystem32Xcnd. exe 


C:\Docunents and Settings \huangjuanshi\.android>keytool -list -keystore debug .ke 
ystore 
tei ke ys tore 27 15 


Keystore ÆR. JKS 
Keystore +E BE. SUN 


您 的 keystore AÊ 1 HA 


androiddebugkey, 2611-12-21. PrivateKeyEntrvy, 
T UEBEX XMD5».  83:04:31:6E:D8:98:08:38:BF: E1 : CF: D1: CB:B6 :38:C7 


图 11-1 获取 Android SDK 的 指纹 信息 


接着 ,打开 API Key 的 申请 页 面 : http://code.google.com/intl/zh-CN/android/maps-api-signup.html， 把 之 前 查询 到 的 指纹 MD5 值 复制 并 粘贴 上 去 ， 按 下 “Generate API Key” 按 钮 就 可 以 生成 
API Key 了 ， 此 过 程 可 能 需要 用 户 登录 ， 大 家 使 用 已 有 的 Google 账 号 登录 即 可 。 此 申请 页 面 如 图 11-2 所 示 。 


Android Maps APIs Terms of Service 


|l > 


Last Updated: October 13, 2008 


Thanks for your interest in the Android Maps APIs. The Android 
Maps APIs are a collection of services (including, but not limited to, 
the "com.google.android.maps.MapView” and 
"android.location.Geocoder* classes) that allow you to include maps, 
geocoding, and other content from Google and its content providers 
in your Android applications. The Android Maps APIs explicitly do 
not include any driving directions data or local search data that may 
be owned or licensed by Google. 


1. Your relationship with Google. v 
. 1.1. Your use of any of the Android Maps APIs (referred to in this — .-: 


| have read and agree with the terms and conditions (printable version) 
My certificate's MD5 fingerprint: 03:04:31:6E:D8:90:00:38:0F:E1:CF:D1:CB:B6:38:C7 | 


Generate API Key 


图 11-2 Google Map API Key 申 请 页 面 


Google 除 了 会 给 我 们 返回 API Key 的 信息 ， 还 会 返回 一 段 Android 配 置 文件 代码 ， 方 便 我 们 直接 复制 和 粘贴 到 项 目 代码 中 去 ， 如 代码 清单 11-1 所 示 。 


代码 清单 11-1 


<com.google.android.maps .MapView 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: apikey="0whheja-ZkpucnDW1tCSB£VZXTakV7ImkIt1zAg" 
/> 


IR] 


2. 导 入 包含 地 


实例 的 app-demos-special 项 目 


接 下 来 ， 使 用 Eclipse 的 Import 工 具 导入 源 代 码 目录 下 的 app-demos-special 项 目 (目录 名 为 special) ， 也 称 作 special 应 用 。 此 项 目 已 经 包含 了 本 章 中 的 所 有 实例 ， 当 然 也 包括 本 节 的 Google Map 实 
例 了 。 该 项 目的 主要 界面 控制 器 类 都 在 com.app.demos.special.demo 类 包 下 ， 地 图 实例 的 代码 文件 是 DemoMap.java， 对 应 的 逻辑 实现 如 代码 清单 11-2 所 示 。 


代码 清单 11-2 


package com.app.demos.special.demo; 
import com.app.demos.special .R; 
import com.google.android.maps.GeoPoint; 
import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapController; 
import com.google.android.maps.MapView; 
import android.os.Bundle; 
public class DemoMap extends MapActivity { 
MapView map; 
MapController mapController; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.demo map); 
map =(MapView) this.findViewById(R.id.demo map view); 


map.setTraffic (true); // 交通 地 图 ， 若 需 使 用 请 打开 注释 
map.setSatellite (true); // 卫星 地 图 ， 若 需 使 用 请 打开 注释 
map.setStreetView (true) ; // 街景 地 图 ， 这 里 默认 使 用 此 模式 


map.setEnabled (true) ; 
map.setClickable (true) ; 
map.setBuiltInZoomControls (true); 
mapController = map.getController(); 
mapController.animateTo (new GeoPoint((int) (31.237141*1000000), (int) (121.501622*1000000))); 
mapController.setZoom(15) ; 

} 

GOverride 

protected boolean isRouteDisplayed() ( 
// TODO Auto-generated method stub 
return false; 


我 们 可 以 看 到 ，DemoMap 类 的 逻辑 比较 简单 ， 主 要 逻辑 都 在 onCreate 方 法 中 ， 这 里 主要 用 到 了 MapView 和 MapController 两 个 类 。 


(1) MapView 类 


MapView 类 对 应 的 是 Google Map 特 有 的 MapView 控 件 ， 也 就 是 界 
所 示 。 


模板 中 的 com.google.android.maps.MapView 控 件 ， 这 里 顺便 介绍 一 下 地 图 实例 的 模板 文件 demo_map.xml， 如 代码 清单 11-3 


四 


代码 清单 11-3 


<?xml version="1.0" encoding="ut£-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
<com.google.android.maps .MapView 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:apiKey-"Owhheja-ZkpucnDWltC5BfVZXTakV7ImkItlzAg" 
android: id="@+id/demo_map_view" 
/> 


</LinearLayout> 


实例 的 模板 布局 非常 简单 ， 整 个 UI 界面 都 被 MapView 控 件 所 覆盖 。 该 模板 的 运行 效果 可 参考 图 11-6。 


从 以 上 模板 代码 中 可 以 看 出 ， 地 | 


[ 


(2) MapController 类 


MapController 类 是 Google Map 中 控制 元 件 的 管理 器 类 ， 主 要 用 于 操控 Google Map 的 动作 行为 ， 比 如 放大 缩小 、 坐 标 移动 等 。 另 外 ， 这 里 还 使 用 GeoPoint 类 指定 了 地 图 的 中 心 位 置 ， 即 纬度 
31.237141、 经 度 121.501622， 也 就 是 上 海 市 陆家嘴 地 区 的 中 心 位 置 。 


另外 ， 在 使 用 Google Map API 进 行 功能 开发 的 过 程 中 ， 有 三 个 要 点 需要 我 们 特别 注意 ， 现 归纳 如 下 。 


四 | 


要 点 一 : 由 于 整合 Google Map 需 要 用 到 Google API， 所 以 在 选择 项 目 类 库 时 ， 我 们 需要 选择 对 应 的 Google APl 作 为 项 目的 Android SDK 版 本 ， 如 


11-3 所 示 。 


要 点 二 : 由 于 使 用 Google Map API 需 要 引入 第 三 方 的 Java 类 包 ， 所 以 我 们 需要 在 项 目 配置 文件 AndroidManifest.xml 中 的 <application/> 标 签 中 加 入 Google Map SDK 库 的 引用 配置 ， 如 <uses- 
library android: name="com.google.android.maps"/> 。 否 则 ， 运 行 过 程 中 可 能 出 现 致命 错误 。 


Properties for app-demos-special 


ltype filter text 


E Resource 
Android 
Builders 
Java Build Path 
(Java Code Style 
Java Compiler 
z Java Editor 
Javadoc Location 
Project References 
Refactoring History 
Run/Debug Settings 
SVN 版 本 控制 
Task Repository 
Task Tags 
XML Syntax 


Android 


Target Name 


In Android 1.5 
[C] Google APIs 
C] Android 1.6 
C] Google APIs 


C] Android 2.1... 


C] Google APIs 
[C] Android 2. 2 
Et " 


C] Rea13D Add-On 
C Android 2.3.1 


C Android 2.3.3 


[] Google APIs 
C] Android 3.0 
[] Google APIs 
C] Android 3.1 
[] Google APIs 


- Project Build Target 


| Vendor 


Android Üpen Seurce Pro... 


Google Inc. 


Android Open Source Pro... 


Google Inc. 


Android Open Source Pro... 


Google Inc. 
Android - — Source Pro... 


KYOCERA Try 
LGE 


Android Open Source Pro... 


Google Inc. 


Sony Ericsson Mobile Co... 
Android Open Source Pro... 


Google Inc. 


Android Open Source Pro... 


Google Inc. 


Android Open Source Pro... 


Google Inc. 


. 


EDIT & Q OQ > 
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BJ11-3 i&4£Google API 作 为 项 目的 Android SDK 版 本 


要 点 三 : 在 使 用 Google Map 的 com.google.android.maps.MapView 控 件 时 必须 传 入 API Key。 传 入 方法 有 两 种 : 我 们 可 以 在 XML 模板 的 MapView 控 件 中 加 入 android: apiKey 属 性 ; 也 可 以 使 用 
Java 代 码 来 创建 MapView 控 件 ， 如 代码 清单 11-4 所 示 。 


代码 清单 11-4 


http: //www.hzcourse.com/resource/ readBook?path-/c a /teach_ebook/uncompressed/15327/OEBPS/Text/.. 
MapView map = new MapView(this, “API Key 字 符 串 值 ” 
http: //www.hzcourse.com/resource/readBook?path=/ RM /teach ebook/uncompressed/15327/OEBPS/Text/ . 


3 .编译 和 运行 地 图 实例 项 目 


熟悉 完 项 目 实例 代码 之 后 ， 下 面 就 可 以 进行 项 目 实例 的 编译 和 运行 工作 了 。 由 于 地 图 应 用 使 用 的 SDK 为 Google AP1， 我 们 也 需要 创建 一 个 目标 SDK 为 Google API 的 Android 虚 拟 机 来 运行 此 项 目 ， 比 如 
这 里 选用 的 是 与 Android 2.2 版 本 相对 应 的 Google APIs-API Level 8 来 作为 虚拟 机 的 运行 库 。 该 虚拟 机 配置 如 图 11-4 所 示 。 
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图 11-4 虚拟 机 配置 


右键 单 击 app-demos-special 项 目 ， 然 后 选择 Run As 菜单 中 的 Android Application 选 项 ， 就 可 以 编译 并 运行 此 项 目 了 。 编 译 、 安 装 之 后 ， 我 们 就 可 以 在 Android 模 拟 器 上 看 到 special 应 用 的 主 界面 ， 


如 图 11-5 所 示 。 


首先 ,我 们 会 看 到 app-demos-special 项 目的 主 界面 ， 该 界面 上 包含 了 所 有 实例 的 入 


例 ) 、Demo Camera (摄像 头 实例 ) 、Demo Media (多 媒体 实例 ) 以 及 Demo Voice (语音 识 


所 示 。 


别 实例 ) 。 


按钮 。 这 些 按钮 从 上 到 下 分 别 是 Demo Map (地 图 实例 ) 、 
当 我 们 点 击 “Demo Map” 按 钮 之 后 ， 就 可 以 打开 地 图 实例 的 界面 了 ， 显 示 效 果 如 图 


Demo LBS (LBS 功 能 实例 ) 、Demo Sensor ( 传 感 
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图 11-5 ”Special 应 用 主 界面 
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中 我 们 可 以 看 到 ， 地 | 
模式 和 卫星 地 图 模式 。 


D 


D 


11.2 ”使 用 LBS 功 能 


大 地 坐标 ) ， 在 GIS (Geographic 


实例 的 界面 中 展示 了 以 上 海 市 陆家嘴 为 中 心 的 附近 


11-6 ”地 图 实例 的 界面 


区 域 的 街景 地 图 ， 当 然 大 家 还 可 以 通过 使 用 DemoMap 类 代码 中 的 setTraffic 和 setsatellite 方 法 来 选择 地 | 


的 模式 ， 包 括 


D 


LBS (Location Based Service， 基 于 地 理 位 置信 息 的 服务 ) 是 通过 电信 移动 运 莒 商 的 无 线 电 通讯 网 络 (如 GSM 网 、CDMA 网 ) 或 外 部 定位 方式 (AGPS) 获取 移动 终端 用 户 的 位 置信 息 (地 理 坐标 或 


nformation System， 地 理 信 息 系统 ) 平台 的 支持 下 ， 为 


合 可 以 创造 出 非常 有 创意 的 LBS 应 用 ， 比 如 国外 的 Foursquare， 国 内 的 街 旁 、 切 客 等 。 


LBS 技 术 的 核心 是 定位 技术 ， 简 单 来 说 就 是 用 户 设备 所 在 的 经 纬度 信息 ， 根 
方式 可 分 为 GPS 定位 和 基站 定位 (网络 定 位 ) 两 科 


， 这 两 种 定位 方式 各 有 长 短 。 


户 提供 相应 服务 的 一 种 增值 业务 。 目 前 LBS 技 术 在 商业 中 的 应 用 越 来 越 广泛 ， 特 别 是 与 Google Map API 相 结 


遇 此 信息 我 们 可 以 进行 深度 的 数据 挖掘 ， 比 如 可 以 计算 出 用 户 附近 的 交通 信息 、 商 业 信息 甚至 其 他 用 户 等 。 


目前 重要 的 定位 


- GPS 定位 。GPS 定 位 的 优点 是 比较 精确 ， 根 据 我 们 内 部 的 测试 数据 ， 平 均 精度 在 10 米 左右 ， 另 外 还 包含 高 度 信息 ; 而 缺点 则 是 信息 返回 比较 慢 ， 定 位 时 间 往 往 在 几 十 秒 到 几 分 钟 不 等 ， 室 内 信和 号 通常 
比较 弱 。 


“ 基站 定位 。 基 站 定位 的 优点 是 响应 速度 快 ， 一 般 是 秒 级 别 的 ， 但 是 问题 是 定位 不 够 精确 ， 据 我 们 内 部 的 测试 数据 ， 平 均 精 度 在 500 米 左右 。 


Android 系 统 为 我 们 准备 了 android.location 包 来 处 理 定位 相关 的 功能 。android.location 包 中 重要 的 类 库 说 明 如 下 。 


: android.location.Address: 地 址 信息 类 ,使 用 Geocoder 类 进行 查询 ， 会 返回 Address 对 象 数据 来 表示 查询 所 得 的 地 址 信息 。 


: android.location.Criteria: 定位 基准 信息 类 ， 用 于 设置 定位 方式 (Provider) 的 选择 标准 。 配 合 getBestProvider 可 用 于 选择 比较 适合 的 定位 方式 。 


: android.location.Geocoder: 提供 正 向 和 反 向 的 地 理 编码 功能 ， 正 向 地 理 编 码 是 把 地 址 信息 (Address) 转化 为 地 理 坐 标 (Location) 的 过 程 ， 反 向 地 理 编码 的 过 程 则 是 相反 的 。 不 


过 ， 由 于 种 种 原因 


Geocoder 类 已 不 再 提供 服务 ， 如 果 想 要 继续 使 用 地 址 查询 业务 ， 请 参考 https://developers.google.com/maps/documentation/geocoding/ ，Google 提 供 了 基于 JSON 协 议 的 HTTP 接 口 ， 方 式 和 我 们 的 微 博 实例 差 不 


多 ， 


击 “Demo LBS" 按钮， 就 可 以 进入 LBS 实 例 的 界 


大 家 可 以 尝试 使 用 HttpClient 来 查询 。 


- android.location.Location: 地 理 坐 标 类 ， 主 要 用 于 存储 地 理 位 置 的 经 纬度 、 位 置 加 速度 等 信息 。 另 外 ， 还 提供 了 便捷 的 坐标 计算 方法 ， 比 如 distanceTo 方 法 就 可 用 于 计算 两 个 坐标 之 间 的 距离 。 


- android.location.LocationManager: 位 置信 息 管理 类 ， 提 供 了 一 系列 方法 来 处 理 与 地 理 位 置 相关 的 问题 ， 包 括 查 询 上 一 个 已 知 位 置 ， 注 册 和 清除 来 自 菜 个 LocationProvidet 的 周期 1 


- android.location.LocationProvider: 定位 方式 提供 者 类 ， 提 供 多 种 定位 方式 供 开 发 者 选择 ， 比 如 GPS 定 位 、 基 站 定位 (网 络 定位 ) 等 。 


下 面 我 们 通过 一 个 实例 来 说 明 Android 系 统 中 LBS 定 位 技术 的 使 F 


方法 。 实 际 上 ，app-demos-special 项 目 中 同样 已 经 包含 了 与 LBS 功 能 相关 的 应 用 实例 ， 在 该 应 用 的 主 菜单 界面 (如 


代码 清单 11-5 


面 ， 显 示 效果 请 参考 图 


11-8。LBS 实 例 的 界 


Ë 


控制 器 类 是 com.app.demos.special.demo 包 下 的 DemoLbsjava， 如 代码 清单 11-5 所 示 。 


生 的 位 置 更 新 等 。 


IR] 


11-5 所 示 ) 中 点 


package com.app.demos.special.demo; 
import java.text.DecimalFormat; 

import com.app.demos.special .R; 

import android.app.Activity; 

import android.content.Context; 

import android. location.Criteria; 

import android. location.Location; 

import android. location.LocationListener; 
import android. location. LocationManager; 
import android.os.Bundle; 

import android.widget.Toast; 


public class DemoLbs extends Activity implements LocationListener { 


private LocationManager lm; 


private String provider = LocationManager.GPS_PROVIDER; 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.demo lbs); 
// 初始 化 位 置 类 
initLocation () 7 

} 

GOverride 

protected void onResume() { 
super.onResume () ; 
if (1m != null) { 


im. requestLocationUpdates (provider, 3000, 0, this); 


} 

} 

GOverride 

protected void onPause() ( 
super.onPause () ; 
if (1m != null) { 

lm. removeUpdates (this); 

} 

š 

private void initlocation() { 
Criteria criteria = new Criteria(); 
criteria.setAccuracy (Criteria.ACCURACY_FINE) ; 
criteria. setAltitudeRequired (false) ; 
criteria.setBearingRequired (false) ; 
criteria.setCostAllowed (false) ; 


criteria.setPowerRequirement (Criteria .POWER_LOW) ; 
lm = (LocationManager) this.getSystemService (Context.LOCATION SERVICE); 


if (provider == null) ( 


provider - lm.getBestProvider(criteria, true); 


} 


Location location = lm.getLastKnownLocation (provider); 


// 更 新 地 址 信息 
updateLocation (location) ; 
š 
private void updateLocation (Location location) { 
String result = ""; 
if (location != null) { 
// 获取 经 纬度 信息 
double lat = location.getLatitude () 7 
double Ing = location.getLongitude () ; 


DecimalFormat df = new DecimalFormat ("#.000000") ; 


String latStr = df. format (lat); 
String lngStr = df.format (lng); 


result = "纬度 : " + latStr + "WE: " + IngStr; 


) else ( 
result = "Can not find address"; 


} 


Toast .makeText (this, result, Toast.LENGTH LONG).show(); 


} 

GOverride 

public void onLocationChanged (Location location) ( 
updateLocation (location); 

} 

GOverride 

public void onStatusChanged(String provider, int status, Bundle extras) { 
// TODO Auto-generated method stub 

} 

GOverride 

public void onProviderEnabled (String provider) { 
// TODO Auto-generated method stub 


} 

@Override 

public void onProviderDisabled(String provider) { 
// TODO Auto-generated method stub 

} 


首先 ，DemoLbs 类 实现 了 LocationListener 接 口 ， 其 中 最 重要 的 方法 就 是 onLocation-Changed， 该 方法 在 每 次 位 置信 息 发 生变 化 时 都 会 被 调用 。 另 外 ， 我 们 在 onCreate 方 法 中 使 用 initLocation 方 法 
初始 化 位 置信 息 ， 同 时 在 initLocation 方 法 中 调用 updateLocation 方 法 来 更 新 位 置信 息 。 然 后 ， 在 onResume 方 法 中 使 用 LocationManager 类 的 requestLocationUpdates 方 法 来 注册 定时 更 新 位 置信 息 的 
逻辑 ， 并 且 在 onPause 方 法 中 使 用 LocationManager 类 的 removeUpdates 方 法 来 注销 定时 更 新 的 逻辑 。 


接着 ， 我 们 来 重点 分 析 initLocation 和 updateLocation 方 法 的 逻辑 。 首 先是 initLocation 方 法 ， 其 中 最 重要 的 逻辑 就 是 初始 化 了 LocationManager 对 象 ， 然 后 通过 getLastKnownLocation 方 法 获取 到 
最 新 的 定位 数据 ， 也 就 是 Location 对 象 。 另 外 ， 这 里 我 们 使 用 了 默认 的 设置 ， 即 LocationManager.GPS_PROVIDER， 也 就 是 使 用 GPS 定位 的 方式 来 获取 位 置信 息 。 然 后 是 updateLocation 方 法 ， 这 里 我 们 
通过 Location 对 象 的 getLongitude 和 getLatitude 方 法 获取 最 新 定位 数据 中 的 经 纬度 信息 ， 最 后 再 借助 Toast 组 件 打印 出 来 。 


分 析 过 代码 ， 接 下 来 就 是 编译 和 运行 该 实例 应 用 了 ， 操 作 方 法 和 之 前 的 地 图 应 用 一 样 ， 在 主 界面 中 点 击 “Demo LBS” 按 钮 即 可 进入 LBS 实 例 界面 。 测 试 时 ， 我 们 可 以 通过 DDMS 中 的 “Location 
Controls” 工 具 来 向 Android 模 拟 器 发 送 虚拟 的 GPS 经 纬度 信息 ， 如 图 11-7 所 示 。 


在 该 界面 中 ， 我 们 可 以 输入 需要 模拟 的 经 纬度 数值 ， 比 如 输入 经 度 -122.084095、 纬 度 37.422005。 然 后 ， 点 击 “Send” 按 钮 ， 就 可 以 在 Android 模 拟 器 中 的 LBS 实 例 界面 中 看 到 获取 到 的 最 新 位 置信 息 
了 ， 效 果 如 图 11-8 所 示 。 实 际 上 ， 以 上 操作 就 是 触发 了 DemoLbs 类 中 的 onLocationChanged 人 方法 。 


LI 


I ul 


(9 Decimal 
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Longitude |-122. 084085 | 


Latitude Ej 422005 


11-7 发 送 虚 拟 的 GPS 经 纬度 信息 
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11-8 获取 经 纬度 信息 


至 此 ，LBS 实 例 的 实现 逻辑 已 经 介绍 完毕 ， 实 例 界面 的 模板 文件 demo _lbs.xml， 如 代码 清单 11-6 所 示 。 


代码 清单 11-6 


<?xml version-"1.0" encoding-"utf-8"?» 


<LinearLayout xmlns:andro: 
android: orientation 
android: layout_widt! 


"http: //schemas .android.com/apk/res/android" 
ertical" 
fill parent" 


android: layout_height="fill_parent"> 
<TextView 


android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:layout_weight="1" ~ 
android:gravity="center" 
android:text="Demo LBS"/> 


</LinearLayout> 


113 ”使 用 传感器 


Android 系 统 支 持 丰 富 的 传感器 (Sensor) 类 型 ， 常 见 的 传感器 包括 加 速度 、 重 力 感 上 应、 方向、 压力、 亮度、 地磁 、 温 度 等 ， 详 细 信 息 如 表 11-1 所 示 。 每 个 传感器 都 是 非常 有 用 的 ， 我 们 可 以 利用 它们 
来 实现 多 种 多 样 的 有 趣 功能 ， 比 如 很 多 游戏 使 用 重力 感应 传感器 SensorTYPE_GRAVITY 来 作为 用 户 的 操作 方式 ， 微 信 应 用 的 “ 摇 一 摇 ” 功 能 就 是 使 用 的 加 速度 传感器 SensorTYPE_ACCELEROMETER 来 实 


现 的 。 


属性 
Sensor. TYPE ACCELEROMETER 
Sensor. TYPE GRAVITY 
Sensor. TYPE GYROSCOPE 
Sensor. TYPE LIGHT 
Sensor. TYPE MAGNETIC FIELD 
Sensor. TYPE ORIENTATION 
Sensor. TYPE PRESSURE 
Sensor. TYPE TEMPERATURE 


说 明 
加 速度 传感器 
重力 感应 传感器 
陀螺 仪 传感器 
亮度 传感器 
地 磁 传感器 
方向 传感器 
压力 传感器 
温度 传感器 


采样 率 包括 实时 采样 、 游 戏 采 样 、 普 通 采样 、 应 


特定 的 采样 率 可 


采样 四 种 ， 详 细 说 明 见 表 11-2。 在 使 用 时 我 们 需要 注意 的 是 ， 当 我 们 设 定 不 同 的 采样 率 时 ， 其 实 只 是 对 传感器 系统 的 一 个 提示 或 者 建议 ， 并 不 能 保证 
， 所 以 以 上 4 种 采样 率 的 准确 性 分 别 对 应 的 是 高 、 中 、 低 、 不 可 靠 。 对 于 一 些 基于 传感器 功能 的 应 用 和 游戏 ， 我 们 建议 使 用 实时 采样 ， 即 SensorManager.SENSOR_DELAY_FASTEST。 


表 11-2 ”传感器 采样 项 


属性 


SensorManager. SENSOR DELAY FASTEST 
SensorManager.SENSOR DELAY GAME 
SensorManager.SENSOR DELAY NORMAL 
SensorManager.SENSOR DELAY UI 


说 明 
实时 采样 ， 尽 可 能 快 地 采集 传感器 数据 
游戏 采样 ， 对 游戏 应 用 比较 合适 的 采集 速度 
普通 采样 ， 默 认 的 采集 速度 ， 和 屏幕 方向 有 关 
应 用 采样 ， 对 普通 应 用 比较 合适 的 采集 速度 


限于 篇 幅 ， 我 们 不 可 能 对 所 有 的 Android 传 感 器 都 做 详细 介绍 ， 下 面 我 们 挑选 其 中 最 常 
(Sensor.TYPE_GRAVITY) 。 


首先 ， 我 们 必须 了 解 一 下 Android 重 力 感应 系统 的 坐标 系 ， 也 是 加 速度 传感器 使 


下 方 , 如 


到 的 传感器 来 介绍 ， 包 括 加 速度 传感器 (Sensor.TYPE_ACCELEROMETER) 以 及 重力 感应 传感器 


的 坐标 系 。 和 Android 图 形 开发 所 用 的 坐标 系 不 同 (可 参考 2.8.3 节 ) ， 重 力 感应 系统 的 坐标 系 原点 位 于 竖 屏 模式 的 左 
图 11-9 所 示 。X、Y、Z 三 个 方向 轴 分别 代 表 的 是 屏幕 的 宽度 、 长 度 和 深度 方向 的 加 速度 值 ， 数 值 为 -10 到 10; 我 们 可 以 把 重力 的 反方 向 ， 也 就 是 朝天 的 方向 表示 为 正 数 ， 比 如 : 手机 屏幕 朝 上 (Z 轴 


SEX) ， 也 就 是 水 平 放置 时 ，X、Y、Z 的 值 分 别 是 9?、0、10; 而 手机 垂直 放置 (Y 轴 朝天 ) 时 ，X、Y、Z 的 值 分 别 是 0、10、0。 如 果 感 觉 不 好 理解 ， 大 家 可 以 用 自己 的 手机 来 摆 放 演示 。 


在 实 


际 应 


中 ， 我 们 可 以 从 传感器 类 中 获取 最 新 的 X、Y、Z 值 ， 然 后 根据 这 3 个 值 求 三 角 函 数 ， 从 而 获得 该 设备 相对 于 重力 方面 的 摆 放 角度 。 本 节 的 传感器 实例 将 展示 在 不 同 状态 下 的 X、Y、Z 的 值 。 在 


Special 应 用 的 主 菜单 界面 (如 图 11-5 所 示 ) 中 点 击 “Demo Sensor" 按钮 ， 就 可 以 进入 传感器 实例 的 界面 ， 如 图 11-10 所 示 。 


wl) © 2:05 


See all your apps. 


Touch the Launcher icon. 


11-9 重力 感应 坐标 系 


Demo Sensor 


Xi 0.0, y: 33.77622 , z: 0.813417 


图 11-10 ”获取 传感器 数值 


可 以 看 到 ,图 11-10 是 Android 模 拟 器 在 默认 的 竖 屏 模式 下 ， 程 序 从 加 速度 传感器 获取 到 的 Xx、Y、Z 轴 方向 的 加 速度 值 。 借 此 我 们 正好 可 以 验证 之 前 提 到 的 ， 在 重力 坐标 系 下 各 个 方向 的 加 速度 取 值 方 


式 。 另 外 ， 我 们 注意 到 这 里 取得 的 是 比较 精准 的 浮 点 值 (float) ， 与 理论 值 有 些许 偏差 是 在 所 难免 的 。 


另外 ， 我 们 使 用 “Ctrl+F11” 组 合 键 把 模拟 器 切换 为 横 屏 模式 ， 此 时 坐标 原点 也 随 之 移动 到 横 屏 模式 的 右 下方， 按照 之 前 的 坐标 系 来 看 ， 此 时 X 轴 方向 上 面 的 加 速度 是 10， 其 他 两 轴 上 的 加 速度 都 为 0， 
和 实际 值 也 基本 相符 ， 如 图 11-11 所 示 。 


SOT 


D,z:0.813417 


图 11-11 横 屏 模式 获取 传感器 数值 


接着 ， 我 们 来 分 析 传感器 实例 的 代码 。 其 界面 控制 器 类 的 代码 位 于 com.app.demos.special.demo 类 包 下 面 的 DemosSensorjava 文 件 中 。 逻 辑 实现 如 代码 清单 11-7 所 示 。 


代码 清单 11-7 


package com.app.demos.special.demo; 
import com.app.demos.special.R; 
import android.app.Activity; 
import android.hardware.Sensor; 
import android.hardware.SensorEvent; 
import android.hardware.SensorEventListener; 
import android.hardware.SensorManager; 
import android.os.Bundle; 
import android.widget.TextView; 
public class DemoSensor extends Activity ( 
private Sensor sensor; 
private SensorManager sm; 
private TextView textResult; 
private float x, y, z; 
private String result - ""; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.demo sensor); 
textResult = (TextView) this.findViewById(R.id.demo sensor text result); 
try { 


rManager) this.getSystemService (SENSOR SERVICE); 
sensor = sm.getDefaultSensor(Sensor.TYPE ACCELEROMETER) ; 
// 创建 监听 吕 
SensorEventListener sel = new SensorEventListener() { 
GOverride 
public void onSensorChanged(SensorEvent event) { 
x = event.values[SensorManager.DATA_X]; 
y = event .values[SensorManager.DATA_Y]; 
z = event.values [SensorManager.DATA Z]; 
result ="x:"+x4",y:"+tyt",2:3"4 3; 
textResult.setText (result) ; 
} 
GOverride 
public void onAccuracyChanged (Sensor sensor, int accuracy) { 
// TODO Auto-generated method stub 


// 注册 监 " 

sm.registerListener (sel, sensor, SensorManager.SENSOR DELAY GAME); 
} catch (Exception e) { 

e.printStackTrace () ; 
} 


DemoSsensor 类 的 主要 逻辑 都 在 onCreate 方 法 中 ， 逮 辑 比较 简单 。 首 先 ， 通 过 SensorManager 获 取 加 速度 传感器 ， 即 Sensor.TYPE_ACCELEROMETER。 其 次 ， 创 建 传感器 监听 器 类 ， 也 就 是 
SensorEventListener 类 ， 并 实现 其 中 的 onSensorChanged 方 法 ， 每 当 传 感 器 的 返回 值 发 生变 化 时 都 会 调用 此 方法 ， 这 里 我 们 会 取得 X、Y、Z 轴 方向 的 加 速度 并 显示 在 界面 的 TextView 控 件 中 。 最 后 ,使 用 
SensorManager 的 registerListener 方 法 来 注册 监听 器 ， 并 按照 游戏 采样 率 (SensorManager.SENSOR_DELAY_GAME) 的 频率 来 进行 数据 采样 。 


回 


另外 ，SensorManager 类 还 提供 了 getsensorList 方 法 用 以 获取 设备 支持 的 传感器 列表 信息 ， 我 们 可 以 此 为 据 来 判断 设备 是 否 支持 对 应 传感器 的 功能 。 至 于 其 他 传感器 的 用 法 ， 同 加 速度 传感器 差 不 
多 ， 都 可 以 使 用 SensorEventListener 监 听 器 类 来 实现 。 


至 此 ， 传 感 器 实例 的 实现 逻辑 已 经 介绍 完毕 ， 实 例 界 面 的 模板 文件 demo_sensorxml， 如 代码 清单 11-8 所 示 。 


代码 清单 11-8 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:gravity-"center"» 
<TextView 
android: layout width-"fill parent" 
android:layout height-"wrap content" 
android:padding-"10dip" 
android:gravity-"center" 
android:text-"Demo Sensor"/» 
<TextView 
android: id="@+id/demo_sensor_text_result" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:padding="10dip' 
android:gravity="center"/> 
</LinearLayout> 


114 ”使 用 摄像 头 


据 相 关 统计 ， 在 Android 设 备 中 用 摄像 头 进行 拍照 和 摄像 是 用 户 最 喜欢 使 用 的 功能 之 一 ， 因 此 使 用 摄像 头 也 就 成 了 智能 手机 设备 最 重要 的 特色 功能 之 一 。 使 用 摄像 头 的 拍照 和 摄像 功能 可 以 帮助 我 们 开 
发 出 很 多 有 趣 的 Android 应 


在 Android 系 统 中 使 用 摄像 头 功能 ， 先 要 了 解 3 个 核心 功能 类 ， 即 Camera、surfaceView 和 MediaRecorder， 这 几 个 类 分 别 用 于 摄像 头 的 总 控 、 预 览 和 录像 功能 ， 下 面 我 们 就 来 学 习 这 3 个 核心 类 的 基 
本 概念 。 


1.Camera 类 


Camera 类 是 摄像 头 设 备 的 主要 AP1， 用 于 控制 摄像 头 设备 的 开启 、 关 闭 预览 以 及 拍照 等 动作 ， 此 类 的 具体 用 法 我 们 会 在 后 面 的 相机 拍照 实例 中 详细 介绍 。 使 用 前 ， 我 们 必须 先 在 Android 应 用 的 配置 文 
件 中 把 使 用 权限 加 上 ， 相 关 使 用 权限 及 其 用 法 请 参考 代码 清单 11-9。 


代码 清单 11-9 


«t-- 摄像 头 的 使 用 权限 一 -> 

<uses-permission android:name="android.permission.CAMERA" /> 

<!-- 照片 或 者 视频 保存 到 SDCard 中 的 权限 一 -> 

<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE"/> 

<!-- 摄像 功能 的 使 用 权限 ，android:required 属 性 为 false 表 示 可 能 用 到 --> 7 

<uses-feature android:name="android.hardware.camera" android:required="false" /> 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


2.SurfaceView 类 


[R] 


SurfaceView 类 继承 自视 图 类 (View) ， 可 以 直接 从 内 存 中 获取 图 像 数据 ， 是 Android 系 统 中 一 个 非常 重要 的 绘图 容器 。SurfaceView 可 以 在 主线 程 之 外 的 线程 中 进行 屏幕 绘图 ， 这 样 就 可 以 避免 绘 


任务 过 于 繁重 时 造成 主线 程 阻塞 。 实 际 上 ， 在 游戏 开发 中 我 们 也 经 常用 到 SurfaceView， 关 于 这 点 可 参考 第 13 章 中 的 相关 内 容 。 


3.MediaRecorder 类 


MediaRecorder (媒体 录制 器 类 ) 主要 用 于 音频 和 视频 录制 等 相关 功能 中 。 在 Android 系 统 中 ，MediaRecorder 以 状态 机 的 形态 运行 ， 它 拥有 自己 的 生命 周期 ， 其 主要 状态 包括 初始 化 状态 
(Initialized) 、 数 据 源 配置 (DataSourceConfigured) 、 准 备 录制 状态 (Prepared) 、 录 制 中 (Recording) 以 及 录制 结束 (Released) ， 每 个 状态 都 有 需要 执行 的 动作 ， 具 体内 容 如 图 11-12 所 示 。 


[D 


描述 了 在 媒体 录制 器 类 (MediaRecorder) 生命 周期 状态 的 变化 过 程 中 ， 其 主要 类 方法 的 调用 ， 其 中 比较 重要 的 方法 的 用 法 归纳 如 下 。 


上 


网 


: reset: 把 MediaRecorder 重 设 到 初始 状态 。 

- release: 释放 MediaRecorder 对 象 。 

- SetAudioSource: 设置 音频 的 来 源 ， 常 见 的 来 源 有 麦克 风 MIC、 摄 像 头 CAMCORDER 等 ， 更 多 信息 请 参考 SDK 中 的 MediaRecorder AudioSource 类 。 
“ setOutputFile: 设置 音 视 频 的 保存 文件 位 置 。 


- setOutputFormat: 设置 音 视频 的 保存 格式 ， 常 见 的 有 3GP 格 式 THREE_GPP、MPEG 格 式 MPEG_4 等 ， 更 多 信息 请 参考 SDK 中 的 MediaRecorder.OutputFormat 类 。 


reset( ) 
发 生 错 误 或 进行 


一 次 无 效 的 调用 —uko ) 


release() » 
rese 


Released Initialized 


setAudioSource( Y 
setVideoSource( ) 


stop() set( JutputFormat( ) 


Recording DataSourceConfigured 
SetAudioEncoder ) 
setVideoEncoder( ) 
reset() prepare() Out) 
setV ideoSize ) 
setV ideoFrameRate{ ) 
setPreviewDisplay( ) 


图 11-12 MediaRecorder 生 命 周期 


“ setMaxDuration: 设置 音 视频 的 最 长 时 间 。 

: setVideoSource: 设置 视频 的 来 源 ， 常 见 的 来 源 有 摄像 头 CAMERA 等 ， 更 多 信息 请 参考 SDK 中 的 MediaRecorder.VideoSource 类 。 
: setVideoSize: 设置 视频 的 屏幕 尺寸 。 

- start: 启动 MediaRecorder。 

' stop: 停止 MediaRecorder。 


了 解 完 上 述 基 本 概念 之 后 ， 接 下 来 我 们 来 看 一 人 app-demos-special 项 目 中 的 相机 拍照 实例 ， 在 应 用 的 主 菜 单 界面 ( 见 图 11-5) 点 击 “Demo Camera” 按 钮 就 可 以 进入 相机 拍照 界面 ， 显 示 效 果 如 图 
11-13 所 示 。 


需要 注意 的 是 ， 由 于 需要 在 Android 模 拟 器 中 进行 模拟 拍照 ， 所 以 我 们 必须 先 给 模拟 器 加 上 “Camera support” 功能。 在 相机 拍照 界面 中 ， 有 一 个 不 断 移 动 的 方块 来 模拟 摄像 头 场景 的 变化 ， 接 着 按 
T “Take Photo” 按 钮 ， 就 可 以 把 照片 保存 下 来 了 。 我 们 在 DDMS 的 File Explorer (文件 浏览 ) 窗口 中 打开 /mnt/sdcard/ 目 录 ， 就 可 以 看 到 保存 好 的 jpg 图 像 文 件 ， 如 图 11-14 所 示 。 
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图 11-13 相机 拍照 实例 界面 


B Threads. 8 Heap @ Allocation Tracker 


Name Size Date Time Permissions 
由 (> data 2012-06-18 08:30 drwxrwx--x 
S 区 ant 2012-07-03 05:06 drwxrwxr-x 
对 asec 2012-07-03 05:06 drwxr-xr-x 
=) 区 sdcard 2012-07-03 05:18  d---rwxr-x 
由 (& Android 2012-07-02 10:40  d-—rwxr-x 
& (> DCIM 2012-02-09 09:27  d---rwxr-x 
由 (z» LOST. DIR 2011-12-19 11:27 d---rwxr-x 
À demo camera 1341292526192. jpg 42453 2012-07-03 05:15  ----rwxr-x 


Ej11-14 File Explorer 窗 口中 查看 保存 的 图 像 
相机 拍照 实例 的 界面 控制 器 代码 位 于 com.app.demos.special.demo 包 目录 下 的 DemoCamera.java 文 件 中 ， 如 代码 清单 11-10 所 示 。 


代码 清单 11-10 


package com.app.demos.special.demo; 
import java.io.File; 
import java.io.FileOutputStream; 
import com.app.demos.special.R; 
import android.app.Activity; 
import android.content.Context; 
import android.graphics.Bitmap; 
import android.graphics.Bitmap.CompressFormat; 
import android.graphics.BitmapFactory; 
import android.graphics.PixelFormat; 
import android.hardware.Camera; 
import android.hardware.Camera.PictureCallback; 
import android.os.Bundle; 
import android.os.Environment; 
import android.view.Display; 
import android.view.KeyEvent; 
import android.view.SurfaceHolder; 
import android.view.SurfaceView; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.view.Window; 
import android.view.WindowManager; 
import android.widget.Button; 
public class DemoCamera extends Activity ( 
Camera camera; 
SurfaceView viewCamera; 
Button btnTakePhoto; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
// 设置 窗口 全 屏 模式 
Window window = this.getWindow(); 
this.requestWindowFeature (Window.FEATURE NO TITLE); 
window.setFlags (WindowManager.LayoutParams.FLAG FULLSCREEN, 
WindowManager.LayoutParams.FLAG FULLSCREEN); 
window.addFlags (WindowManager.LayoutParams.FLAG KEEP SCREEN ON); 
super.onCreate (savedInstanceState); 
setContentView(R.layout.demo camera); 
// 设置 摄像 头 预 览 控件 
ViewCamera = (SurfaceView) this.findViewById(R.id.view_camera); 
ViewCamera.getHolder () .setFixedSize (800, 480); 
viewCamera.getHolder().setType(SurfaceHolder.SURFACE TYPE PUSH BUFFERS); 
viewCamera.getHolder() .addCallback (new CameraSurfaceCallback()); 
// 设置 拍照 按钮 点 击 事件 
btnTakePhoto = (Button) this.findViewById(R.id.btn take photo); 
btnTakePhoto.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick(View v) { 
camera.takePicture (null, null, new TakePhotoCallback()); 
) 


n; 


) 
public boolean onKeyDown (int keyCode, KeyEvent event) 1{ 
if (camera != null) { 
if (event.getRepeatCount() == 0) ( 
switch (keyCode) { 
case KeyEvent.KEYCODE DPAD CENTER: 

camera.takePicture (null, null, new TakePhotoCallback()); 
break; 


) 
] 
return super.onKeyDown (keyCode, event); 
) 
private final class CameraSurfaceCallback implements SurfaceHolder.Callback ( 
private boolean isPreview; 
GOverride 
public void surfaceCreated(SurfaceHolder holder) ( 
try { 
camera = Camera.open(); 
WindowManager wm = (WindowManager) getSystemService (Context .WINDOW_SERVICE) ; 
Display display = wm.getDefaultDisplay (); 
int displayWidth = display.getWidth (); 
int displayHeight = display.getHeight (); 
Camera.Parameters params = camera.getParameters (); 
// 设置 预览 窗口 的 尺寸 
params.setPreviewSize (displayWidth, displayHeight); 
// 设置 预览 帧 数 
params .setPreviewFrameRate (3); 
// 设置 照片 格式 
params.setPictureFormat (PixelFormat .JPEG) ; 
// 设置 照片 质量 
params.setJpegQuality (80) ; 
// 设置 照片 尺寸 
Params .setPictureSize (displayWidth, displayHeight); 
camera.setParameters (params) ; 
camera.setPreviewDisplay (viewCamera.getHolder ()); 
camera.startPreview(); 
isPreview = true; 
) catch (Exception e) { 
e.printStackTrace(); 
} 
} 


@Override 
public void surfaceChanged(SurfaceHolder holder, int format, int width, 
int height) { 
// TODO Auto-generated method stub 


} 
GOverride 
public void 


surfaceDestroyed(SurfaceHolder holder) { 


if (camera != null) { 


} 
} 


if (isPreview) { 
// 释 放 Camera 对 象 
camera.stopPreview(); 
camera.release(); 
camera = null; 


private final class TakePhotoCallback implements PictureCallback ( 


GOverride 
public void 
try ( 


onPictureTaken(byte[] data, Camera camera) ( 


// 停止 预览 

camera.stopPreview(); 

// 保存 照片 到 SDCard 

String pictureName = "demo camera " + System.currentTimeMillis() 

+ "jpo"; 

Bitmap bitmap = BitmapFactory.decodeByteArray (data, 0, data.length); 
File file = new File (Environment.getExternalStorageDirectory(), pictureName) ; 
FileOutputStream outputStream = new FileOutputStream(file); 
bitmap.compress (CompressFormat .JPEG, 100, outputStream); 
outputStream.close(); 

// 重新 开始 预览 


camera.startPreview(); 


} catch (Exception e) ( 


} 


e.printStackTrace () ; 


DemoCamera 类 的 代码 比较 长 ， 为 了 便于 大 家 理解 ， 我 们 会 按照 由 上 至 下 的 阅读 顺序 ， 把 该 类 中 比较 重要 的 知识 点 逐个 剖析 并 归纳 如 下 。 


(1) 类 属性 


(2) onCreate 方 法 


界面 初始 化 方法 ， 主 要 逻辑 如 下 。 首 先 使 
SurfaceView 控 件 ， 初 始 化 逻辑 在 预览 窗口 的 回调 接口 类 CameraSurfaceCallback 中 ; 最 后 设置 拍照 按钮 ， 即 “Take Photo” 按 钮 ， 这 里 用 到 了 Camera 类 的 takePicture 方 法 ， 


的 回调 接口 类 TakePhotoCallback 中 。 


(3) onKeyDown 方 法 


重 写 按键 事件 ， 这 里 我 们 为 DPAD 的 中 间 按 键 也 设置 了 拍照 事件 ， 此 处 用 法 和 onCreate 方 法 中 的 相同 ， 使 用 的 回调 接 


Window 类 把 相机 窗口 设置 为 全 屏 模 式 ;然后 设置 界面 模板 ， 即 demo_camera.xml， 模 板 代码 见 代码 清单 11-11; 接着 初始 化 摄像 头 预览 窗口 的 


(4) CameraSurfaceCallback 类 


预览 窗口 的 回调 接口 类 实现 了 SurfaceHolder.Callback 接 口 
surfaceCreated 方 法 中 用 到 了 Camera 类 的 open 方 法 打开 摄像 头 ， 然 后 使 用 Camera.Parameters 对 象 来 设置 相机 预览 界 


预览 窗口 开始 预览 。 


m 


(5) TakePhotoCallback 类 


拍照 动作 的 回调 接口 类 实现 了 PictureCallback 接 口 的 onPictureTaken 方 法 ， 也 就 是 在 照片 拍照 完成 时 需要 触发 的 逻辑 。 先 停止 预 


要 属性 包括 摄像 头 API 类 ， 即 Camera 类 对 象 camera、 相 机 预览 界面 SurfaceView 类 对 象 viewCamera， 以 及 拍照 按钮 Button 类 对 象 btnTakePhoto。 


体 的 拍照 逻辑 在 拍照 动作 


类 都 是 TakePhotoCallback。 


的 3 个 方法 ， 即 surfaceCreated、surfaceChanged 以 及 surfaceDestroyed 方 法 ， 分 别 用 在 SurfaceView 控 件 被 创建 、 改 变 和 销毁 的 时 候 。 
的 尺寸 、 帧 数 ， 以 及 照片 的 尺寸 、 质 量 等 信息 。 最 后 ， 调 用 startPreview 方 法 打 


览 动作 ， 然 后 使 用 BitmapFactory 的 decodeByteArray 方 法 把 字 节 数 


据 转化 成 Bitmap 对 象 ， 使 用 FileOutputSstream 类 把 图 像 保 存 到 本 地 SDCard 中 去 ， 最 后 重新 开始 预览 动作 。 至 此 ， 我 们 就 可 以 在 SDCard 中 看 到 最 终 的 相片 文件 了 。 


至 此 ， 相 机 拍照 实例 的 实现 逻辑 已 经 介绍 完毕 ， 下 面 是 其 界面 的 模板 文件 demo_camera.xml， 如 代码 清单 11-11 所 示 。 


代码 清单 11-11 


<?xml version="1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 


<SurfaceView 


android: layout_width="fill parent" 
android: layout_height="fill parent" 


android: layout we. ight="1" 


android:id="@+id/view_camera"/> 


<Button 


android:id="@+id/btn take photo" 
android:layout width-"fill parent" 
android:layout height-"40dip" 
android:background-"Gdrawable/btn common" 
android:layout margin-"1dip" = 
android:text="Take Photo" /> 


</LinearLayout> 


hi 


虽然 相机 拍照 实例 中 并 没有 包含 录像 逻辑 ， 但 是 接 下 来 我 们 还 是 要 介绍 这 个 相对 重 


类 来 进行 视频 的 录制 工作 。 使 


代码 清单 11-12 


MediaRecorder 类 进行 视频 录制 的 用 法 其 实 并 不 复杂 ， 代 码 清单 11-12 就 是 一 个 使 用 范例 。 


的 功能 。 实 际 上 ， 拍 照 和 录像 这 两 个 功能 之 间 的 基本 思路 是 非常 类 似 的 ， 只 是 录像 功能 还 需要 借助 MediaRecorder 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


// 获取 MediaRecorder 对 象 


MediaRecorder mrec = new MediaRecorder () ; 


// 解锁 摄像 头 
camera.unlock(); 
// 设置 录像 参数 


mrec.setCamera (camera) ; 


mrec.setAudioSource (MediaRecorder .AudioSource .CAMCORDER) ; 
mrec.setVideoSource (MediaRecorder.VideoSource.CAMERA); 
mrec.setMaxDuration (100000) ; //ms 4 3-43 


// 设置 录像 文件 


String filename = "demo 


video " + System.currentTimeMillis() + + ".3gp"; 


String cameraDir = ImageManager.CAMERA IMAGE BUCKET NAME; 
String filePath = cameraDir + "/" + filename; 
File cameraDir = new File(cameraDir); 
if (!cameraDir.exists()) { 
cameraDir.mkdirs(); 


) 


mrec.setOutputFile (filePath); 


// 开始 录像 

try ( 
mrec.prepare () ; 
mrec.start(); 

} catch (RuntimeException e) { 
e.printStackTrace () ; 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


以 上 代码 中 可 以 看 到 MediaRecorder 的 基本 用 法 ， 使 用 的 时 候 需 要 注意 两 点 : 其 一 ， 在 开始 录像 之 前 需要 调用 Camera 对 象 的 unlock 方 法 解锁 摄像 头 ， 这 是 因为 摄像 头 在 默认 状态 下 都 是 被 锁定 的 ， 只 
有 解锁 后 才能 被 MediaRecorder 等 多 媒体 进程 调用 。 其 二 ， 调 用 start 方 法 开始 录像 前 ， 必 须 先 用 setOutputFile 方 法 设置 好 录像 文件 的 保存 位 置 ， 这 点 和 拍照 逻辑 不 大 一 样 ， 需 要 引起 注意 。 另 外 ， 录 完 后 
我 们 还 需要 关闭 并 释放 MediaRecorder 对 象 ， 示 例 见 代码 清单 11-13。 


代码 清单 11-13 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
mrec.stop(); ul 
mrec.reset(); 
mrec.release(); 
mrec = null; 
if(camera !- null) ( 
camera.lock(); 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


至 此 ，Android 系 统 中 摄像 头 的 使 用 已 介绍 完毕 。 我 们 建议 大 家 自己 动手 实践 ， 尝 试 把 以 上 的 录像 逻辑 加 入 到 前 面 的 相机 拍照 实例 (DemoCamera 类 ) 中 去 。 这 样 能 让 我 们 更 好 地 理解 Android 使 用 摄 
像 头 进行 开发 的 思路 。 


11.5 “多 媒体 开发 


想 掌握 Android 系 统 的 多 媒体 开发 ， 先 要 了 解 几 个 重点 概念 。 首 先是 Android 系 统 的 多 媒体 框架 (Media Framework) ， 也 就 是 OpenCore 框 架 ; 然后 是 两 个 重要 多 媒体 类 ， 即 MediaPlayer 和 


MediaRecorder。 


1.0penCore 框 架 


OpenCore 框 架 是 Google 联 合 PacketVideo 推 出 的 多 媒体 开源 框架 ， 也 是 Android 系 统 多 媒体 框架 的 核心 。OpenCore 框 架 位 于 Android 系 统 框架 的 类 库 层 (Libraries) ， 所 有 Android 平 台 上 与 音频 和 
视频 的 采集 、 播 放 等 功能 都 是 以 之 为 基础 的 。 另 外 ，OpenCore 框 架 基 于 C/C++ 语言 实现 ， 具 有 非常 好 的 可 移植 性 ， 从 宏观 功能 来 看 ， 它 主要 包含 了 两 大 方面 的 内 容 。 


- PVPlayer: 提供 媒体 播放 器 的 功能 ， 可 用 于 完成 各 种 音频 (Audio) 、 视 频 (Video) 流 的 播放 、 回 放 (Playback) 等 功能 。 


. PVAuthor: 提供 媒体 流 记录 的 功能 ， 可 用 于 捕获 各 种 音频 (Audio) 、 视 频 (Video) 流 的 以 及 静态 图 像 。 


目前 PVPlayer 和 PVAuthor 都 以 SDK 的 形式 提供 给 开发 者 ， 我 们 可 以 在 这 个 SDK 之 上 构建 多 种 应 用 程序 和 功能 服务 ， 当 然 也 包括 在 移动 设备 中 经 常 使 用 的 多 媒体 组 件 ， 例 如 媒体 播放 器 、 录 像 机 、 录 音 
机 等 。 


另外 ， 从 软件 层次 上 来 看 ，OpenCore 框 架 还 包含 了 操作 系统 兼容 库 OSCL (Operating System Compatibility Library) 、PV 多 媒体 框架 PVMF (PacketVideo Multimedia Framework) 以 及 
PVPlayer 和 PVAuthor 的 核心 引擎 等 。 


事实 上 ，OpenCore 框 架 相 当 庞大 且 复 杂 。 比 如 ， 就 播放 功能 来 讲 ， 除 了 媒体 流 控制 、 文 件 解析 、 音 频 视 频 流 的 解码 (Decode) 等 方面 的 内 容 之 外 ， 还 包含 了 与 网 络 相关 的 实时 流 协议 RTSP (Real 
Time Stream Protocol) 的 相关 内 容 ; 而 在 媒体 流 记 录 方 面 ， 则 包含 了 流 的 同步 、 音 频 视 频 流 的 编码 (Encode) 以 及 文件 的 写 入 等 功能 。 然 而 ， 对 于 普通 的 Android 开 发 者 来 讲 ， 我 们 并 不 需要 深入 研究 
OpenCore 框 架 的 底层 实现 ， 只 需要 掌握 Android 框 架 为 我 们 提供 的 组 件 库 即 可 ， 具 体 来 讲 就 是 MediaPlayer 类 和 MediaRecorder 类 。 


2.MediaPlayer 类 


MediaPlayer 类 (媒体 播放 器 类 ) 主要 负责 Android 系 统 中 的 音频 (Audio) 和 视频 (Video) 的 播放 功能 。MediaPlayer 类 是 基于 OpenCore 框 架 实现 的 ， 调 用 方式 是 JNI， 主 要 使 用 了 PVPlayer 的 
API, 


小 贴 士 : JNI (Java Native Interface) 即 Java 本 地 调用 。 从 Java 1.1 开 始 ，JNI 标 准 就 已 经 成 为 Java 平 台 的 一 部 分 ，JNI 允 许 Java 代 码 和 其 他 语言 的 程序 代码 (比如 本 地 的 C/C++ 代码 ) 进行 交互 。 另 外 ，JNI 也 
是 Android NDK 开 发 的 重要 内 容 ， 相 关内 容 请 参考 第 12 章 。 


另外 ， 在 Android 系 统 中 MediaPlayer 类 是 以 状态 机 的 形态 运行 的 ， 拥 有 自己 的 生命 周期 ， 我 们 先 来 看 看 图 11-15 所 示 的 MediaPlayer 类 的 生命 周期 
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图 11-15 ”MediaPlayer 类 生命 周期 


研究 MediaPlayer 类 的 生命 周期 ， 我 们 可 以 得 到 以 下 结论 。 首 先 ，MediaPlayer 类 主要 生命 周期 状态 依次 是 : 空闲 状态 (Idle) 、 初 始 化 状态 (Initialized) 、 准 备 播放 状态 (Prepared) 、 播 放 中 
(Started) 、 暂 停 播放 (Paused) 、 播 放 结束 (Stopped) 等 。 其 次 ，MediaPlayer 类 必须 先 处 于 Prepared 状 态 才 可 以 开始 播放 ， 重 新 调整 播放 时 间 之 后 播放 器 也 会 处 于 这 个 状态 。 


MediaPlayer 类 生命 周期 中 的 重要 方法 归纳 如 下 。 


- pause: 暂停 播放 。 
“ prepare: 执行 播放 的 准备 工作 。 
- reset: 重 设 MediaPlayer 到 初始 状态 。 


- release: 释放 MediaPlayer 对 象 。 


:seekTo: 移动 至 播放 时 间 点 。 

- setDataSource: 设置 音 视频 文件 的 位 置 。 
“ setLooping: 设置 是 否 循环 播放 。 
Start: 开始 MediaPlayet。 


- stop: 停止 MediaPlayer。 


另外 ， 由 于 音频 、 视 频 在 播放 过 程 中 可 能 遇 到 各 种 异常 情况 ， 如 格式 不 支持 、 文 件 不 存在 等 ， 此 时 我 们 可 以 通过 setOnErrorListener 方 法 来 注册 OnErrorListener 监 听 器 类 ， 并 用 其 中 的 OnError 方 法 来 


处 理 这 些 错误 。 


3.MediaRecorder 类 


MediaRecorder 类 (媒体 录制 器 类 ) 也 是 基于 OpenCore 框 架 实现 的 ， 调 


所 以 该 类 的 相关 内 容 已 经 在 11.4 节 中 给 大 家 提前 介绍 过 了 。 与 MediaPlayer 类 相似 ，MediaRecorder 类 也 是 以 状态 机 的 形态 运行 的 ， 也 有 


容 ， 这 里 不 再 歼 述 。 


下 面 我 们 将 通过 一 个 媒体 播放 器 的 实例 来 重点 讲解 一 下 MediaPlayer 类 的 用 法 。 其 实 ， 该 实例 也 在 app-demos-special 中 ， 实 例 入 
之 处 在 于 ， 运 行 前 先 要 通过 DDMS 的 File Explorer 工 具 往 Android 模 拟 器 的 SDCard 


方式 是 JNI， 主 要 使 


了 PVAuthor 的 APl。 


由 于 MediaRecorder 类 经 常用 于 与 摄像 头 (Camera) 配合 来 进行 视频 的 录制 |， 
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当 媒 体 播放 器 应 用 被 打开 时 ， 程 序 将 会 从 SDCard 目 录 中 获取 可 用 于 播放 的 mp3 音 乐 文件 ， 然 后 显示 在 媒体 播放 器 的 
可 以 开始 欣赏 音乐 了 。 当 然 ， 媒 体 播放 器 还 提供 了 其 他 常见 的 播放 器 功能 ， 按 照 底 部 的 功能 按钮 来 看 ， 依 次 是 上 一 首 、 播 放 、 暂 停 以 及 下 一 首 ， 大 家 可 以 


介绍 过 了 媒体 播放 器 的 界面 和 功能 
现 逻 辑 如 代码 清单 11-14 所 示 。 


图 11-16 在 文件 浏览 窗口 中 上 传 mp3 文 件 
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播放 清单 Playlist) 中 ， 界 面 效果 如 


自己 的 生命 周期 ， 至 了 
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于 ， 让 我 们 来 看 看 ， 此 应 用 在 Android 系 统 中 是 如 何 实现 的 。 媒 体 播放 器 的 界面 控制 器 类 位 了 


Bea 


com.app.demos.specia 


法 和 实例 也 请 参考 11.4 节 的 相关 内 


就 是 主 菜单 中 的 “Demo Media” 按 钮 。 但 是 ， 与 其 他 实例 的 不 同 
录 下 传 入 一 些 mp3 音 乐 文件 。 上 传 成 功 之 后 的 效果 如 图 11-16 所 示 。 
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。 接 下 来 ， 点 击 底部 的 播放 按钮 就 


.demo 包 下 的 DemoMedia.java 文 件 中 ， 实 
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11-17 媒体 播放 器 实例 界面 


代码 清单 11-14 


package com.app.demos.special.demo; 
import java.io.File; 
import java.io.FilenameFilter; 
import java.util.ArrayList; 
import java.util.List; 
import com.app.demos.special.R; 
import android.app.Activity; 
import android.media.MediaPlayer; 
import android.media.MediaPlayer.OnCompletionListener; 
import android.os.Bundle; 
import android.view.KeyEvent; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.ArrayAdapter; 
import android.widget.Button; 
import android.widget.ListView; 
public class DemoMedia extends Activity { 
private static final String MUSIC DIR - "/sdcard/"; 
private List«String» musicList = new ArrayList<String>(); 
private boolean musicIsPaused - false; 
private int musicNo - 0; 
private MediaPlayer mediaPlayer; 
private ListView musicListView; 
private Button btnPlayStart; 
private Button btnPlayStop; 
private Button btnPlayPrev; 
private Button btnPlayNext; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.demo media); 
// 获取 音乐 列表 
musiclist(); 
// 初始 化 媒体 播放 器 
mediaPlayer = new MediaPlayer(); 
// 开始 按钮 逻辑 
btnPlayStart = (Button) this.findViewById(R.id.demo media btn play start); 
btnPlayStart.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick(View v) { 
if (musicIsPaused) ( 
mediaPlayer.start(); 
musicIsPaused - false; 
) else ( 
musicPlay (MUSIC DIR + musicList.get (musicNo)); 
Ë 
} 


1; 
// 暂停 按钮 逻辑 
btnPlayStop = (Button) this.findViewById(R.id.demo media btn play stop); 
btnPlayStop.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick(View v) { 
if (mediaPlayer.isPlaying()) ( 
mediaPlayer.pause(); 
musicIsPaused - true; 
} 
} 


1; 
// 上 一 首 按钮 远 辑 
btnPlayPrev = (Button) this.findViewById(R.id.demo media btn play prev); 
btnPlayPrev.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick(View v) { 
musicPlayPrev (); 


} 


he 
// 下 一 首 按 钮 逻辑 
btnPlayNext = (Button) this.findViewById(R.id.demo media btn play next); 
btnPlayNext.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick(View v) { 
musicPlayNext (); 
} 
n; 
} 
public boolean onKeyDown (int keyCode, KeyEvent event) { 
if (mediaPlayer != null) { 
switch (keyCode) { 

Case KeyEvent .KEYCODE BACK: 
mediaPlayer.stop(); 
mediaPlayer.release(); 
mediaPlayer - null; 
break; 

} 
} 
return super.onKeyDown (keyCode, event); 
š 
private void musicPlay(String path) ( 
try { 
mediaPlayer.reset (); 
mediaPlayer.setDataSource (path); 
mediaPlayer.prepare(); 
mediaPlayer.start(); 
mediaPlayer.setOnCompletionListener (new OnCompletionListener () { 

GOverride 

public void onCompletion (MediaPlayer mp) { 
musicPlayNext (); 

} 

n; 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 
private void musicPlayNext() { 
if (++musicNo >= musiclist.size()) { 
musicNo = 0; 
l 
musicPlay (MUSIC DIR + musicList.get (musicNo)); 
f 
private void musicPlayPrev() { 
if (--musicNo < 0) { 
musicNo = musicList.size() - 1; 


} 
musicPlay (MUSIC DIR + musicList.get (musicNo)); 
š 
private void musiclist() ( 
File musicDir = new File(MUSIC DIR); 
File[] musicFiles = musicDir.listFiles(new MusicFilter()); 
if (musicFiles.length > 0) { 
for (File file : musicFiles) ( 
musicList.add(file.getName()); 
š 
musicListView = (ListView) this.findViewById(R.id.demo media list music); 
ArrayAdapter<String> musicListAdapter = new ArrayAdapter«String? (this, 
R.layout.list music item, 
R.id.list music item text name, 
musicList); ~ T ~ 
musicListView.setAdapter (musicListAdapter) ; 
} 
} 
private class MusicFilter implements FilenameFilter { 


GOverride 


public boolean accept(File dir, String filename) ( 


return filename.endsWith (".mp3") ; 


} 


DemoMedia 类 的 代码 比较 多 ， 为 了 便于 大 家 理解 ， 我 们 按照 由 上 至 下 的 阅读 顺序 ， 把 该 类 中 比较 重要 的 知识 点 逐个 剖析 并 归纳 如 下 。 


(1) 类 属性 


BY 


上 一 首 、 下 一 首 功能 按钮 的 逻辑 ， 这 和 


法 和 musicPlayPrev 方 法 主要 根据 当前 曲目 


(2) onCreate 方 法 


EF 要 属性 包括 媒体 播放 器 类 ， 即 MediaPlayer 类 对 象 mediaPlayer、 音 乐 文件 所 在 目录 的 字符 
目的 int 数 值 musicNo， 以 及 播放 器 主要 功能 按钮 的 Button 对 象 等 。 


媒体 播放 器 初始 化 方法 。 首 先 ， 调 


musicList 方 法 获取 音乐 文件 列表 并 显示 在 界面 


(3) onKeyDown 方 法 


媒体 播放 器 的 按键 方法 中 主 


(4) musicPlay、musicPlayNext、musicPlayPrev 方 法 


三 个 方法 分 别 代表 着 开始 播放 、 向 前 选 


由 和 向 后 选 


(5) musicList 方 法 和 MusicFilter 类 


到 了 播放 、 暂 停 前 后 选 


实现 了 后 退 按钮 的 逻辑 ， 即 退出 媒体 播放 器 时 ， 程 序 需要 先 停止 播放 器 ， 然 后 再 释放 mediaPlayer 对 象 。 


的 逻辑 。 其 中 最 重要 的 方法 是 musicPlay， 此 方法 可 获取 参数 中 的 音乐 文件 路 径 ， 然 后 初始 化 mediaPlayer 对 象 并 
的 musicNo 值 来 进行 前 后 选 曲 并 播放 。 


musicList 方 法 通过 java 的 文件 操作 类 File 从 音乐 文件 所 在 


有 后 缀 名 为 .mp3 的 文件 。 


录 (MUSIC_DIR) 中 获取 音乐 文件 的 信息 并 显示 在 界面 上 的 ListView 控 件 里 ， 其 中 还 


ListView 控 件 里 ; 然后 ， 初 始 化 MediaPlayer 对 象 mediaPlayer， 以 供 
等 动作 ， 即 musicPlay、musicPlayNext、musicPlayPrev 等 重要 方法 ， 这 些 方法 的 逻辑 稍 后 就 将 介绍 。 


常量 MUSIC_DIR、 音 乐 文件 列表 有 关 的 List 容 器 对 象 musicList、ListView 控 件 对 象 musicListView、 代 表 


他 方法 使 用 ; 最 后 ， 依 次 实现 播放 、 和 暂停 、 


动 开始 播放 ;musicPlayNext 方 


至 此 ， 媒 体 播放 器 实例 的 实现 逻辑 已 经 介绍 完毕 ， 


代码 清单 11-15 


下 面 是 实例 界面 的 模板 文件 demo_media.xml， 如 代码 清单 11-15 所 示 。 


到 了 文件 名 过 滤器 类 MusicFilter， 该 类 用 于 过 滤 出 所 


<?xml version="1.0" encoding-"utf-8"?» 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: orientation="vertical" 

android: layout_width="fill parent" 

android: layout_height="fill parent"> 

<LinearLayout ` M 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout weight-"1"» 
«ListView ii 


android:id-"G(-id/demo media list music" 


android:layout width-"fill parent" 


android:layout height-"fill parent" 


/> 
</LinearLayout> 
<LinearLayout 
android: orientation="horizontal" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:gravity="center_vertical" 


android: layout 
<Button 
android 
android: 
android: 
android: 
android: 
android: 
/> 
<Button 
android: 
android: 
android: 
android: 
android: 
android 
f= 
<Button 
android: 
android 
android 
android: 
android 
android: 
/> 
<Button 
android 
android: 
android: 
android: 
android: 
android: 
{> 
</LinearLayout> 
</LinearLayout> 


_ weight="5"> 


:layout width-"50dip" 


layout height-"50dip" 

layout weight-"1" 
ayout_margin="10dip" 
id="@+id/demo_media_btn_play prev" 
background="@drawable/play_prev" 


layout_width="50dip" 
layout_height="50dip" 
layout_weight="1" 
ayout_margin="10dip" 
d="@+id/demo_media_btn_play start" 


:background="@drawable/play start" 


layout_width="50dip" 


:layout height-"50dip" 
:layout weight-"1" 


layout margin-"10dip" 


:id="@+id/demo media btn play stop" 


background="@drawable/play_ stop" 


:layout width-"50dip" 


layout height-"50dip" 

layout weight-"1" 

layout margin-"10dip" 
id-"8(*id/demo media btn play next" 
background-"8drawable/play next" 


11.6 语音 识别 


大 家 都 知道 iOS 系 统 中 有 大 名 易 易 的 Siri 功 能 ， 这 些 都 是 基于 语音 识别 技术 的 。 实 际 上 Android 系 统 在 1.5 版 本 的 SDK 中 就 已 经 支持 语音 识别 功能 


模块 不 同 ， 开 发 者 需要 使 


代码 清单 11-16 


Recognizerlntent 消 息 来 调 


Android 系 统 的 语音 组 件 ， 调 


方法 如 代码 清单 11-16 所 示 。 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


Intent intent = new Intent 
// 设置 语音 识别 模式 


(RecognizerIntent.ACTION RECOGNIZE SPEECH); 


intent.putExtra (RecognizerIntent.EXTRA LANGUAGE MODEL, RecognizerIntent.LANGUAGE MODEL FREE FORM); 


， 在 新 版 本 的 SDK 中 更 加 强 了 此 项 功能 。 与 其 他 的 功能 


// 设置 提示 信息 文字 

intent .putExtra (RecognizerIntent.EXTRA PROMPT, "Start Record"); 

startActivityForResult (intent, VOICE_RESULT_REQUEST_CODE) E 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


从 以 上 代码 中 可 以 看 出 ， 我 们 可 以 通过 putExtra 方 法 给 Recognizerlntent 消 息 添加 参数 ， 这 里 我 们 设置 了 语音 识别 模式 为 自由 语音 模式 ， 语 音 组 件 的 提示 文字 是 “Start Record” , Sc E, app- 
demos-special 项 目 也 提供 了 语音 识别 的 应 用 实例 ， 在 special 应 用 主 菜单 中 点 击 “Demo Voice” 按钮 就 可 进入 语音 识别 实例 界面 ， 该 界面 的 布局 也 很 简单 ， 点 击 底部 的 “Start Record” 按 钮 就 可 以 开始 


语音 识别 了 ， 显 示 效 果 如 图 11-18 所 示 。 


Demo Voice 


Can not find device 


start Re cara 


图 11-18 语音 识别 实例 界面 


语音 识别 实例 的 逻辑 代码 在 com.app.demos.special.demo 包 下 的 DemoVoice.java 文 件 中 ， 界 面 控制 器 类 名 为 DemoVoice， 如 代码 清单 11-17 所 示 。 


代码 清单 11-17 


package com.app.demos.special.demo; 
import java.util.ArrayList; 
import com.app.demos.special.R; 
import android.app.Activity; 
import android.content.ActivityNotFoundException; 
import android.content.Intent; 
import android.os.Bundle; 
import android.speech.RecognizerIntent; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.Toast; 
public class DemoVoice extends Activity { 
private static final int VOICE RESULT REQUEST CODE = 1001; 
Button btnStartRecord; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView(R.layout.demo voice); 
btnStartRecord = (Button) this.findViewById(R.id.demo voice btn start record); 
btnStartRecord.setOnClickListener(new OnClickListener()( ^ 7 7 
GOverride 
public void onClick(View v) ( 
try ( 
Intent intent = new Intent (RecognizerIntent.ACTION RECOGNIZE SPEECH); 
intent.putExtra (RecognizerIntent.EXTRA LANGUAGE MODEL, 
RecognizerIntent.LANGUAGE MODEL FREE FORM) ; H 
intent.putExtra (RecognizerIntent.EXTRA PROMPT, "Start Record"); 
startActivityForResult (intent, VOICE RESULT REQUEST CODE); 
} catch (ActivityNotFoundException e) { ` zm > 
Toast.makeText (DemoVoice.this, "Can not find device", 
Toast .LENGTH_ LONG) . show () ; 
} catch (Exception e) { 
e.printStackTrace () ; 


} 


n; 
} 
Protected void onActivityResult (int requestCode, int resultCode, Intent data) { 
if (requestCode == VOICE RESULT REQUEST CODE && resultCode == RESULT OK) { 
ArrayList<String> results = data.getStringArrayListExtra (Recogniz 
erIntent .EXTRA RESULTS); 
StringBuffer sb = new StringBuffer (); 
int resultCount = results.size(); 
for (int i = 0; i < resultCount; i++) { 
sb.append (results.get (i)); 
} 
Toast .makeText (this, sb.toString(), Toast.LENGTH LONG) .show () 7 
super.onActivityResult (requestCode, resultCode, data); 


DemoVvoice 类 的 逻辑 比较 简单 ，onCreate 方 法 中 主要 实现 了 “Start Record” 按 钮 点 击 事件 的 逻辑 ， 这 里 也 用 到 了 Recognizerlntent 消 息 来 传递 参数 给 语音 识别 组 件 ， 需 要 注意 的 是 ， 这 里 尝试 捕获 
ActivityNotFoundException 异 常 ， 若 异常 存在 则 弹出 “Can not find device” 提 示人 信息。 由 于 此 功能 需要 设备 支持 ， 在 模拟 器 上 运行 则 会 抛 出 此 异常 ， 如 图 11-18 所 示 。 


至 此 ， 语 音 识 别 实例 的 实现 逻辑 已 经 介绍 完毕 ， 下 面 是 实例 界面 的 模板 文件 demo_voice.xml， 如 代码 清单 11-18 所 示 。 


代码 清单 11-18 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«TextView T =. 
android: layout_width="fill parent" 
android: layout height-"fill parent" 
android:layout weight-"1" ~ 
android:gravity-"center" 
android:text-"Demo Voice"/» 
«Button 
android:id="@+id/demo voice btn start record" 
android:layout width-"fill parent" 
android:layout height-"40dip" 
android:background-"Gdrawable/btn common" 
android:layout margin-"1dip" 
android:text-"Start Record" /» 
</LinearLayout> 


11.7 Wwe 


本 章 的 内 容 比 较 丰富 ， 主 要 介绍 了 Android 常 规 应 用 功能 之 外 的 特色 功能 ， 包 括 了 Google Map API、LBS 技 术 、 传 感 器 、 摄 像 头 以 及 多 媒体 开发 的 相关 内 容 ， 并 对 每 个 功能 的 应 用 实例 都 进行 了 详细 说 
明 。 由 于 手机 应 用 通常 都 是 以 创意 取胜 的 ， 所 以 本 章 的 内 容 还 是 比较 有 实用 价值 的 ， 建 议 大 家 重点 掌握 。 


第 12 章 Android NDK 开 发 


我 们 知道 ，Java 语 言 是 Android 系 统 的 官方 语言 ， 而 之 前 我 们 介绍 的 也 都 是 基于 Java 语 言 来 进行 的 Android 应 用 开发 。 但 是 这 不 仅 大 大 限制 了 Android 系 统 的 扩展 性 和 灵活 性 ， 也 导致 广大 的 C 和 C++ 开 
发 者 被 拒 之 门 外 。 终 于 在 2009 年 Google 发 布 了 NDK 的 第 一 个 版 本 ， 宣 布 支持 使 用 C 和 C++ 语言 来 开发 Android 程 序 。 这 使 得 “Java 和 C” 的 混合 开发 模式 成 为 现实 ， 并 引起 了 广大 开发 者 的 关注 ， 下 面 我 们 
来 介绍 这 部 分 的 内 容 。 


121 NDK 开 发 基础 


Android NDK 的 全 称 是 Android Native Development Kit， 顾 名 思 义 ， 就 是 原生 代码 调用 ， 实 际 上 就 是 允许 Java 程 序 通过 JNI 调 用 C 或 C+ + 的 动态 链接 库 (so 文件 ) 。Android NDK 和 集成 了 交叉 编译 


器 ， 支 持 ARMV5TE 指 令 集 ， 以 及 JNI 接 口 


但 是 ，NDK 的 出 现 并 不 是 为 了 取代 Android SDK， 实 际 上 也 不 可 能 取代 。 它 
SDK 来 说 存在 着 一 些 劣势 ， 比 如 开发 过 程 复 杂 、 调 试 难 度 大 、 无 法 使 


和 稳定 的 C Library。 帮 助 我 人 


门 实现 Java 和 C 混 合 编程 的 


a5 
只 能 是 


Android 应 用 框架 等 。 因 


发 模式 ， 这 对 开发 者 们 的 帮助 无 疑 是 


巨大 的 。 


对 SDK 的 一 个 有 益 的 补充 ，Android 程 序 的 运行 离 不 开 Dalvik 虚 拟 机 。Google 官 方 也 表示 ， 使 用 NDK 进 行 开发 比 起 
比 ， 开 发 者 们 需要 谨慎 使 用 。 


另外 ， 实 际 上 NDK 并 不 适用 于 大 部 分 的 Android 应 用 ， 原 有 两 方面 : 其 一 ， 对 于 大 部 分 应 用 来 阅 ，Android 应 用 框架 已 经 足够 强大 ， 而 且 应 用 对 于 程序 性 能 的 要 求 通常 不 会 过 于 严 苛 ; 其 
二 ，NDK 适 用 于 比较 独立 的 系统 ， 比 如 游戏 、 仿 真 程序 等 ， 简 单 地 使 用 5 或 C++ 语言 重 写 代码 并 不 会 带 来 大 幅度 的 性 能 提升 。 不 过 ，NDK 的 出 现 对 于 Android 系 统 来 说 还 是 非常 有 意义 的 ， 毕 竟 C 和 C++ 程 
序 员 仍然 是 开发 者 阵营 中 的 绝对 主力 ， 将 这 部 分 人 排除 在 Android 开 发 之 外 ， 显 然 是 不 利于 Android 平 台 发 展 的 。 
12.1.1 使 用 NDK 的 原因 

我 们 为 什么 要 使 用 NDK 呢 ? 原因 主要 有 以 下 三 个 方面 。 

首先 ， 我们 可 以 把 NDK 看 作 是 一 系列 开发 工具 的 集合 ， 使 用 NDK 可 以 帮助 我 们 快速 地 进行 Java 和 C 的 混合 开发 ， 发 挥 两 种 语言 各 自 的 特点 ， 最 大 限度 地 发 挥 系统 的 性 能 。 具 体 来 说 ， 


把 C 或 C++ 代 码 生 成 动 


AMG: 动态 链接 库 (Dynamic Link Library, DLL) 是 C 或 C++ 共享 库 (Shared Library) 的 一 种 ， 其 中 包含 了 可 由 多 个 程序 同时 使 用 的 代码 和 数据 。Windows 系 统 上 的 动态 链接 库 文人 
Linux 上 则 是 so。 另 外 ， 动 态 链接 库 只 有 在 需要 时 才 会 被 装载 至 内 存 空间 中 ， 这 种 方式 不 仅 降低 了 可 执行 文件 的 大 小 和 对 内 存 空间 的 要 求 ， 同 时 也 满足 了 多 进程 共享 的 目的 ， 所 以 受到 广 


想 借助 C 和 C++ 语言 


另外 ， 我 们 都 知道 java 包 是 可 以 被 


其 次 ， 我 们 必须 知道 使 


方式 可 以 满足 某 些 应 


的 安全 性 要 求 。 


12.1.2 ”使 用 NDK 调 用 C 或 C++ 


NDK 调 | 


C 或 C++ 


代码 进行 交互 。JNI 在 Java 系 统 中 的 所 处 层次 和 JRE 以 及 JDK 差 不 多 ， 大 家 可 以 借助 


f 
lj 


N 


程序 从 根本 上 来 讲 是 利 


了 Java 语 言 的 JNI 接 口 


ative 


Method 


Library 


d 


为 了 更 好 地 理解 JNI 的 原理 ， 我 们 可 以 尝试 着 把 JNI 调 
Java 程 序 就 可 以 使 用 代理 类 来 调 


Il/so 


JVM 


的 高 效 性 ， 来 实现 系统 中 的 某 些 复杂 功能 ; 或 者 利用 NDK 来 进行 底层 系统 库 的 调 有 


反 编 译 的 ， 相 对 来 说 动态 链接 库 的 so 文件 就 安全 多 了 。 


， 首 先 我 们 需要 来 介绍 一 下 JNI 的 概念 。 


图 


JRE 
JDK 


HERE (so 文件 ) ， 然 后 再 和 Java 程 序 一 起 打包 成 apk 文 件 。 实 际 上 在 12.2.1 节 中 ， 我 们 将 会 给 大 家 介绍 如 何 


NDK 并 不 能 开发 出 纯 生 的 5 或 C++ 程序 ，Android 程 序 的 最 终 运行 环境 仍然 是 Dalvik 虚 拟 机 。 所 以 ， 在 开发 过 程 中 ，NDK 的 使 


使 用 Eclipse+ADT+CDT 开 发 环境 进行 快速 开发 。 


NDKT. 


后 组 一 般 是 dl， 而 


大 开发 者 的 欢迎 。 
是 需要 分 场合 的 。 我 们 使 用 NDK 的 目的 无 非 是 
， 而 这 些 功能 显然 都 是 Android 应 用 框架 无 法 提供 的 ， 这 也 是 我 们 选择 NDK 的 原因 之 一 。 


因 


图 


12-1 中 的 系统 结构 


OS (Windows/Unix) 


具体 步骤 如 下 所 示 。 


1) 实现 Java 类 ， 并 声明 本 地 native 方 法 。 


2) 使 用 avac 工 具 生成 Java 调 用 类 的 class 文 件 。 
3) 使 用 avah 工 具 生成 C 或 C++ 本 地 方法 的 头 文件 。 


4) 实现 C 或 C++ 本 : 


也 方法 的 逻辑 ， 原 则 上 可 以 调用 任何 系统 资源 。 


图 12-1 


此 ， 我 们 可 以 使 


系统 结构 图 


看 做 是 一 种 代理 模式 (Proxy Pattern) ， 包 含 native 接 


NDK 的 开发 模式 ， 将 一 些 核心 算法 或 者 保密 逻辑 使 


JNI 是 Java Native Interface 的 缩写 ， 中 文 为 Java 本 地 调 上 
来 理解 。 


口 方法 的 Java 类 就 是 一 个 代理 类 ， 而 方法 实现 则 在 对 应 的 本 : 


本 地 方法 (Native Method) 中 逻辑 。 当 然 ， 实 际 上 JNI 的 内 部 实现 远 比 以 上 过 程 来 得 复杂 ; 然而 ， 对 于 开发 者 来 说 ， 我 们 更 需要 关心 的 是 使 


C 开 发 ， 然 后 通过 JNI 进 行 调用 ， 这 种 


，JNI 允 许 Java 代 码 和 其 他 语言 写 的 


也 C 或 C++ 代 码 中 ， 其 他 的 


JNI 进 行 开发 的 开发 步 又， 


5) 使 用 Make 工 具 生成 动态 链接 库 (so 文件 或 dll 文 件 ) 。 
6) 编译 、 发 布 并 运行 java 程序 。 


实际 上 ， 进 行 Android NDK 开 发 时 ， 也 要 遵循 上 述 的 JNI 开 发 步骤 ， 唯 一 的 区 别 在 于 NDK 开 发 环境 帮助 我 们 集成 了 常用 的 开发 、 编 译 工 具 ， 简 化 了 JINI 程 序 开发 的 步骤 ， 相 关 实 例 可 参考 12.2.2 节 。 下 
面 ， 我 们 先 来 看 看 Android 系 统 中 Android 应 用 、NDK 环 境 、JNI 系 统 以 及 其 他 重要 元 素 之 间 的 关系 ， 如 图 12-2 所 示 。 


Native Library 
dil/so 


图 12-2 JNI 开 发 步骤 


上 图 从 全 局 角度 展示 了 JNI 系 统 和 NDK 工 具 集 在 Android NDK 开 发 中 所 起 到 的 作用 ， 简 要 分 析 如 下 。 


首先 ，JNI 在 程序 层 (Android Program) 中 扮演 着 重要 角色 ， 它 是 Android 程 序 与 C 或 C+ + 共享 库 之 间 的 桥梁 ，Android 应 用 中 的 Java 程 序 就 是 通过 JNI 来 调用 动态 链接 库 中 的 方法 逻辑 的 。 


另外 ，NDK 工 具 集 则 扮演 了 Android NDK 开 发 中 “协调 者 ”的 角色 。 比 如 ， 在 本 地 5 或 C++ 代码 编译 成 动态 链接 库 的 过 程 中 就 用 到 了 NDK 工 具 集中 的 GNU Make 工 具 ， 在 应 用 打包 的 时 候 ndk-build 工 
具 会 帮助 我 们 把 动态 链接 库 和 Android 程 序 一 起 打包 成 APK 文 件 。 


最 后 ， 我 们 来 看 一 段 在 NDK 开 发 中 用 到 的 标准 实例 代码 (如 代码 清单 12-1 所 示 ) ， 并 简单 说 明 一 下 ， 在 Android NDK 环 境 中 使 用 Java 和 (进行 混合 开发 的 基本 方法 。 
代码 清单 12-1 


Android Java 代 码 : 


public class HelloJni extends Activity 
{ 


// 加 载 动 态 链接 库 (1ibhello-jni.so) 
Static { 
System. loadLibrary ("hello-jni"); 


// 定义 本 地 C 或 C++ 方法 
public native String sayHello(); 
// Androidi¥ $} 
GOverride 
public void onCreate (Bundle savedInstanceState) 


http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/... 


本 地 C++ 代码 : 


#include <string.h> 
#include <jni.h> 
#5Java6G, £ 
jstring 
Java_com_example_hellojni_HelloJni_sayHello(JNIEnv* env, jobject thiz) 
{ 
return (*env)-»NewStringUTF (env, "Hello JNI !"); 


以 上 代码 包括 两 个 部 分 ，Android 中 的 Java 代 码 和 本 地 C++ 代码 。 首 先 ， 在 Java 代 码 中 声明 了 需要 实现 的 native 方 法 sayHello， 此 方法 在 使 用 System.loadLibrary 加 载 动 态 链接 库 之 后 就 可 以 使 用 了 。 
然后 在 对 应 的 C++ 代码 中 实现 与 sayHello 方 法 对 应 的 本 地 方法 ， 这 里 我 们 会 发 现 本 地 方法 名 是 使 用 “Java 包 名 + 类 名 + 方法 名 ”的 格式 来 定义 的 ， 这 样 既 便 于 开发 者 理解 ， 也 方便 代码 管理 。 


12.1.3 Android.mk 和 Application.mk 


自己 的 打包 配置 文件 ， 这 些 文件 以 mk 为 后 缀 。 其 中 最 重要 的 是 Android.mk 文 件 和 


一 个 成 熟 的 开发 框架 必然 有 自己 的 打包 系统 ， 比 如 C 或 C++ 项 目 中 的 make 文 件 、Java 项 目 中 的 ant 工 具 等 ，NDK 也 有 
Application.mk 文 件 ， 下 面 我 们 将 详细 介绍 。 


1.Android.mk 文 件 


于 帮助 NDK 编 译 器 把 本 地 代码 和 类 库 一 起 打 


Android.mk 文 件 是 NDK 的 编译 脚本 ， 用 于 把 C 或 C++ 代 码 编译 成 so 文件 。 一 般 来 说 ， 该 文件 位 于 C 工 程 的 代码 根 目 录 ， 如 图 12-3 所 示 。Android.mk 文 件 F 
包 成 指定 的 动态 链接 库 文件 。 
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12-3 工程 代码 根 目录 


先 来 看 一 个 标准 的 Android.mk 文 件 的 代码 范例 ， 如 代码 清单 12-2 所 示 。 


代码 清单 12-2 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 

LOCAL MODULE := hello-jni 

LOCAL SRC FILES := hello-jni.c 
include $ (BUILD SHARED LIBRARY) 


接 下 来 ， 我 们 来 逐 行 分 析 Android.mk 文 件 的 代码 范例 ， 进 而 学 习 一 下 Android.mk 文 件 的 重要 语法 。 


(1) LOCAL PATH: =$ (call my-dir) 


LOCAL PATH 是 每 个 Android.mk 文 件 都 必须 定义 的 ， 用 于 指定 项 目的 根 目录 ， 编 译 器 会 在 此 目录 树 中 查找 代码 源 文件 。 另 外 ，“call my-dir” 语 句 返 回 的 是 当前 目录 路 径 。 


(2) include$ (CLEAR VARS) 


include 语 法 用 于 包含 外 部 库 (C Library) ，CLEAR_VARS 由 编译 系统 提供 ， 对 应 的 GNU Makefile 脚 本 会 为 我 们 清除 LOCAL_PATH 以 外 的 所 有 以 LOCAL 为 前 缀 的 变量 ， 如 LOCAL MODULE, 
LOCAL SRC FILES, LOCAL STATIC_LIBRARIES 等 。 这 是 必要 的 ， 因 为 所 有 的 编译 控制 文件 都 在 同一 个 GNU Make 环 境 中 。 


小 贴 士 : GNU Make 是 UNIX 系 统 下 的 一 个 工具 ， 设 计 之 初 是 为 了 方便 C 程 序 的 编译 过 程 。 使 用 MAKE 工 具 ， 我 们 可 以 将 大 型 的 项 目 分 解 成 多 个 易于 管理 的 模块 ， 对 于 比较 大 型 的 C 或 C++ 项 目 ， 使 用 Make 


和 Makefile 工 具 可 以 取代 复杂 的 命令 行 操作 ， 高 效 地 处 理 模块 代码 之 间 的 关系 ， 大 大 提高 开发 效率 。 


(3) LOCAL MODULE: =hello-jni 


LOCAL MODULE 也 是 必须 定义 的 ， 用 于 标识 C 工 程 中 的 各 个 模块 ， 最 终 的 链接 库 文 件 的 名 称 也 与 此 值 有 关 ， 比 如 这 里 生成 的 so 文件 名 就 是 libhello-jni.so。 另 外 ，LOCAL_MODULE 值 必须 是 唯一 的 ， 
且 不 能 含有 空格 。 


(4) LOCAL_SRC_FILES: =hello-jni.c 


LOCAL SRC_FILES 用 于 指定 C 工 程 的 源 代 码 文件 ， 当 然 如 果 包 含 多 个 文件 可 以 使 用 人” 符号 进行 换行 。 这 里 不 需要 包含 头 文件 ， 系 统 会 自动 为 我 们 准备 好 。 另 外 ， 如 果 要 使 用 不 同 的 C++ 文件 名 ， 可 


以 通过 配置 LOCAL DEFAULT_CPP_EXTENSION 参 数 来 指定 。 


(5) include$ (BUILD SHARED LIBRARY) 


BUILD_SHARED_LIBRARY 也 由 编译 系统 提供 ， 对 应 的 GNU Makefile 脚 本 会 为 我 们 收集 所 有 以 LOCAL 为 前 缀 的 变量 ， 这 可 以 让 C 工 程 的 类 库 和 代码 更 加 清晰 ， 而 我 们 也 可 以 通过 配置 参数 
BUILD_STATIC_LIBRARY 来 生成 静态 库 。 比 如 ， 使 用 “include$ (BUILD STATIC LIBRARY) ”就 将 生成 以 .a 为 后 缀 的 静态 库 。 


当然 ， 除 了 前 面 介绍 的 常用 系统 变量 ， 如 CLEAR_VARS、BUILD_SHARED_LIBRARY 以 及 BUILD_STATIC_LIBRARY 之 外 ，Android.mk 文 件 还 支持 以 下 变量 。 


: TARGET ARCH: 用 于 指定 CPU 类 型 ， 常 见 的 值 有 arm 和 x86。 
- TARGET PLATFORM: 用 于 指定 Android 平 台 的 版 本 。 


: TARGET ARCH ABI: 用 于 指定 CPU+ABI 的 类 型 ， 比 如 armeabi 就 代表 Armv5TE 的 指令 集 架 构 。 虽 然 目 前 支持 的 类 型 只 有 两 种 ， 但 是 在 未 来 的 NDK 版 本 中 可 能 会 出 现 更 多 的 选择 。 


然后 ， 再 来 看 看 除了 常用 的 模块 描述 变量 ， 如 LOCAL_ PATH, LOCAL MODULE, LOCAL SRC FILES 以 及 LOCAL CPP_EXTENSION 之 外 ，Android.mk 文 件 还 支持 的 变量 。 


: LOCAL C INCLUDES: 可 选项 ， 表 示 C 或 C++ 头 文件 的 搜索 路 径 ， 一 般 是 项 目 目录 的 相对 路 径 。 


: LOCAL CFLAGS: 可 选 的 编译 选项 ， 在 编译 C 代 码 时 使 用 ， 在 使 用 附加 包 或 者 宏 定 义 的 时 候 比 较 有 用 ， 比 如 LOCAL_CFLAGS: =-DHHH 等 价 于 头 文件 中 的 #define HHH, 
: LOCAL CXXFLAGS: 同 LOCAL_CFLAGS， 只 不 过 针对 的 是 C++ 代码 。 

: LOCAL CPPFLAGS: 同 LOCAL_CFLAGS ， 对 C 或 者 C++ 代码 都 适用 。 

- LOCAL STATIC LIBRARIES: 表示 模块 编译 时 需要 用 到 的 静态 库 。 

: LOCAL SHARED LIBRARIES: 表示 模块 编译 时 需要 用 到 的 共享 库 (动态 库 ) 。 


: LOCAL LDLIBS: 编译 时 需要 使 用 的 链接 器 选项 ， 比 如 -1z 就 代表 需要 链接 到 libz.so 库 。 


最 后 ， 再 来 学 习 一 下 Android.mk 文 件 中 可 用 的 宏 定义 。 


- my-dir: 返回 当前 目录 。 

: all-subdir-makefiles: 返回 所 有 子 目录 的 Android.mk 文 件 的 路 径 列表 。 
- this-makefile: 返回 当前 Android.mk 文 件 的 路 径 。 

“ parent-makefile: 返回 调用 数 中 父 级 的 Android.mk 文 件 路 径 。 


2.Application.mk 文 件 


Application.mk 文 件 用 于 描述 项 目 需要 包含 的 原生 模块 (静态 库 或 动态 库 ) ， 我 们 可 以 将 其 看 做 是 Android.mk 文 件 的 补充 ， 常 与 Android.mk 文 件 处 于 相同 的 目录 下 ， 也 就 是 C 工 程 的 代码 根 目录 。 虽 
然 大 部 分 情况 下 ， 我 们 并 不 需要 修改 此 文件 ， 但 是 我 们 还 是 需要 学 习 一 人 Application.mk 文 件 的 可 用 变量 。 


: APP PROJECT PATH: 用 于 给 出 应 用 程序 工程 的 根 目录 的 一 个 绝对 路 径 。 
: APP MODULES: 用 于 列 出 应 用 所 需 的 所 有 模块 ， 如 果 没 有 定义 ，NDK 将 会 对 Android.mk 中 声明 的 默认 模块 进行 编译 。 


: APP_OPTIM : 可 选 模式 有 release 或 debug 两 种 ， 分 别 表示 编译 的 应 用 是 发 布 版 还 是 调试 版 的 。 如 果 是 发 布 版 (release 模 式 ) ， 编 译 器 会 生成 更 加 优化 的 二 进 制 文件 ， 利 于 运行 ; 而 调试 版 (debug 模 
x) 则 更 利于 调试 。 


- APP_CFLAGS: 功能 同 Android.mk 的 LOCAL_CFLAGS。 

, APP_CXXFLAGS: I) fE F] Android.mk tJ LOCAL. CXXFLAGS. 

- APP_CPPFLAGS: 功能 同 Android.mk 的 LOCAL_CPPFLAGS 。 

- APP. BUILD SCRIPT: 指定 编译 脚本 ， 默 认 情 况 下 NDK 编 译 器 会 在 项 目的 jni 目 录 下 寻找 名 为 Android.mk 的 文件 。 


: APP ABl: 选择 指令 集 ， 可 选项 包括 armeabi、armeabi-v7a 以 及 x86。 


Android.mk 和 Application.mk 编 译 脚本 是 NDK 开 发 必 备 的 重要 知识 ， 是 我 们 必须 重点 掌握 的 内 容 。 另 外 ， 关 于 Android.mk 肢 本 的 使 用 案例 ， 我 们 将 在 12.2.2 节 介绍 首 个 NDK 项 目的 开发 中 进行 讲解 。 


122 NDK 开 发 入 门 


前 面 已 经 介绍 了 NDK 开 发 的 基础 知识 ， 接 下 来 就 是 “理论 结合 实践 ”的 时 候 了 ， 在 NDK 开 发 入 门 一 节 中 ， 我 们 将 重点 介绍 NDK 开 发 环境 的 搭建 ， 并 引导 大 家 完成 自己 的 第 一 个 NDK 项 目 。 


1221 开发 环境 搭建 


在 学 习 Android 开 发 基础 时 ， 我 们 已 经 介绍 过 Eclipse 和 ADT 组 合 而 成 的 Android 开 发 环境 ， 详 见 2.10 节 中 的 内 容 。 其 实 NDK 的 开发 环境 也 是 建立 在 这 个 基础 开发 环境 之 上 的 ， 


1. 安 装 Android NDK 


最 新 的 NDK 版 本 可 以 从 Android 官 方 开发 者 站 点 下 载 : http://developer.android.com/sdk/ndk/index.html。 它 支持 目前 主流 的 三 大 操作 系统 ， 即 Windows、Mac OS X (intel) 和 Linux 32/64- 
bit (x86) ; 以 下 是 目前 稳定 版 Android NDK r7 各 操作 系统 安装 包 的 下 载 地 址 。 


- Windows: http://dl.google.com/android/ndk /android-ndk-r7-windows.zip 
- Mac OS X (intel) : http: / /dl.google.com/android/ndk /android-ndk-r7-darwin-x86.tar.bz2 


- Linux 32/64-bit (x86) : http: / /dl.google.com/android/ndk /android-ndk-r7-linux-x86.tar.bz2 


首先 我 们 需要 知道 ， 本 书 介绍 的 是 基于 Windows 系 统 的 NDK 开 发 。 下 载 Windows 版 的 安装 包 之 后 ， 解 压 并 复制 到 相应 目录 ， 建 议 与 Android SDK 放 在 一 起 ， 比 如 D: \android-ndk-r7。 该 目录 下 包含 
了 NDK 的 运行 环境 和 工 


2. 安 装 CDT (C&C++Development Tooling) 


由 于 NDK 主 要 使 用 C 或 C++ 进行 开发 ， 所 以 我 们 要 为 Eclipse 安装 CDT 插 件 。 为 Eclipse 安装 CDT 的 方法 很 简单 ， 首 先 ， 打 开 Help 莱 单 的 “Install New Software” 安 装 界面 ， 选 
$& "Indigo-http://download.eclipse.org/releases/indigo" 选项 (如 果 没 有 此 项 可 点 击 右边 的 Add 按 钮 进行 添加 ) ; 然后 ， 选 中 “Programming Languages” 下 面 的 “CDT Visual C++Support” ii 
项 ; 接着 按 正常 程序 进行 安装 即 可 。 安 装 界面 如 图 12-4 所 示 。 
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12-4 CDT 安 装 界面 


安装 完毕 之 后 我 们 就 可 以 开始 NDK 的 开发 之 旅 了 。 紧 接着 我 们 将 通过 创建 自己 的 首 个 NDK 项 目 来 让 大 家 学 会 如 何 使 用 NDK 开 发 环境 。 当 然 ， 除 了 CDT 之 外 ,我 们 也 可 以 选择 其 他 的 C 或 C++ 开 发 工具 ， 
比如 Cygwin 等 。 不 过 考虑 到 开发 环境 的 方便 性 和 统一 性 ， 还 是 建议 大 家 使 用 Eclipse+ADT+CDT 的 组 合 。 


12.22 首 个 NDK 项 目 


实际 上 ，NDK 的 安装 包 的 samples 示 例 中 已 经 包含 了 NDK 开 发 基本 范例 ， 即 HelloJni 项 目的 完整 源码 。 接 下 来 ， 我 们 先 来 学 习 如 何在 NDK 开 发 环境 中 创建 项 目 。 首 先 ， 打 开 项 目 创建 向 导 ， 新 建 一 个 
Android 项 目 ， 如 图 12-5 所 示 。 


在 Android 项 目 创建 界面 中 选择 “Create Project from existing source" 选项， 然后 从 本 地 目录 选择 界面 中 找到 NDK 目 录 (D: \android-ndk-r7) 下 的 samples/hello-jni 目 录 并 选中 ， 如 图 12-6 所 


接着 ， 我 们 就 可 以 在 Android 项 目 创建 界面 中 看 到 自动 创建 好 的 HelloJni 项 目的 信息 ， 如 图 12-7 所 示 。 另 外 ， 我 们 可 以 注意 到 Eclipse 会 根据 AndroidManifest.xml 中 的 配置 自动 选择 Android 1.5 的 SDK 
来 使 用 。 
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图 12-5 创建 一 个 Android 项 目 
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点 击 Finish 按 钮 后 ，Eclipse 会 在 Package Explorer 中 自动 创建 一 个 名 为 HelloJni 的 Android 项 目 ， 这 就 是 首 个 使 


示 。 
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12-7 ”创建 HelloJni 项 目 
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NDK 开 发 的 Hello World 项 目 了 。 我 们 可 以 先 观察 一 下 该 项 目的 目录 结构 ， 如 医 


12-8 所 


HelloJni 项 目的 目录 结构 和 普通 Android 项 目 差不多 ， 但 是 我 们 会 注意 到 ， 除 了 源 代码 目录 src、 自 动 生成 文件 目录 gen、 资 源 文件 目录 res 之 外 ， 还 多 出 了 一 个 jni 目 录 ， 实 际 上 此 目录 就 是 NDK 项 目的 本 


地 C 或 C++ 源 代码 目录 ， 其 中 包含 了 Android.mk 编 译 脚 本 和 hello-jni.c 程 序 的 源码 文件 ， 这 两 个 文件 的 源 代码 分 另 


在 代码 清单 12-3 和 代码 清单 12-4 中 ， 下 面 我 们 来 简 重 


分 析 一 下 。 


=) BB com. example, hellojni 
E |J] HelloTni. java 
gen [Generated Java Files] 


H EA Android 1.5 


= = Android, mk 


default, properties 


图 12-8 ”HelloJni 项 目的 目录 结构 


代码 清单 12-3 


Copyright (C) 2009 The Android Open Source Project 


Licensed under the Apache License, Version 2.0 (the "License"); 
you may not use this file except in compliance with the License. 
You may obtain a copy of the License at 


http://www.apache.org/licenses/LICENSE-2. 0 


Unless required by applicable law or agreed to in writing, software 
distributed under the License is distributed on an "AS IS" BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
See the License for the specific language governing permissions and 
limitations under the License. 


SE SE SE dbdb HE HE SE HE HE HE HE de dE 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 

LOCAL MODULE := hello-jni 
LOCAL SRC FILES := hello-jni.c 
include $(BUILD SHARED LIBRARY) 


从 上 述 代码 中 可 以 看 出 HelloJni 项 目的 Android.mk 编 译 脚本 非常 简单 ， 仅 指定 了 本 地 模块 名 和 源 代 码 ， 可 以 说 是 最 简单 的 Android.mk 文 件 示例 。 而 代码 清单 12-4 就 是 其 指定 的 程序 文件 hello-jni.c 的 代 
码 实 现 。 


代码 清单 12-4 


/* 
* Copyright (C) 2009 The Android Open Source Project 
* 


* Licensed under the Apache License, Version 2.0 (the "License"); 


* you may not use this file except in compliance with the License. 

* You may obtain a copy of the License at 

* 

* http: //www.apache.org/licenses/LICENSE-2.0 

* 

* Unless required by applicable law or agreed to in writing, software 
* distributed under the License is distributed on an "AS IS" BASIS, 

* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
* See the License for the specific language governing permissions and 
* limitations under the License. 

* 

*/ 


#include <string.h> 
#include <jni.h> 
/* This is a trivial JNI example where we use a native method 
* to return a new VM String. See the corresponding Java source 
* file located at: 
* 
*  apps/samples/hello-jni/project/src/com/example/HelloJni/HelloJni.java 
ee 
jstring 
Java com example hellojni HelloJni stringFromJNI( JNIEnv* env, jobject thiz ) 
{ 
return (*env)-»NewStringUTF (env, "Hello from JNI !"); 


) 


hello-jni.c 文 件 代码 中 的 Java_com_example_hellojni_HelloJni_stringFromJN|I 方 法 是 对 应 用 主要 Activity 界 面 类 HelloJni 中 stringFromJNI 接 口 的 实现 ，HelloJni 类 的 逻辑 实现 如 代码 清单 12-5 所 示 。 
Java com example hellojni HelloJni stringFromJNI 方 法 的 逻辑 很 简单 ， 就 是 返回 一 个 字符 串 ， 即 “Hello from JNI! ”。 从 Hellojni 类 的 实现 逻辑 来 看 ， 返 回 的 字符 串 将 被 显示 在 应 用 界面 的 TextView 
中 。 项 目的 最 终 运行 效果 如 图 12-15 所 示 。 


代码 清单 12-5 


package com.example.hellojni; 
import android.app.Activity; 
import android.widget.TextView; 
import android.os.Bundle; 
public class HelloJni extends Activity 
{ 
/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle savedInstanceState) 
{ 
super.onCreate (savedInstanceState) ; 
/* Create a TextView and set its content. 
* the text is retrieved by calling a native 
* function. 
*/ 
TextView tv = new TextView(this); 
tv.setText( stringFromJNI() ); 
setContentView (tv); 
} 
/* A native method that is implemented by the 
* 'hello-jni' native library, which is packaged 
* with this application. 
* 
/ 
public native String stringFromJNI (); 
/* this is used to load the 'hello-jni' library on application 
* startup. The library has already been unpacked into 
* /data/data/com.example.HelloJni/lib/libhello-jni.so at 
* installation time by the package manager. 
* 
/ 
static { 
System. loadLibrary ("hello-jni") ; 
i) 


了 解 HellojJni 项 目的 主要 代码 逻辑 之 后 ， 回 过 头 继续 进行 HellojJni 项 目的 编译 器 配置 工作 。 在 Eclipse 中 ， 我 们 可 以 为 每 个 项 目 配置 自 定义 的 编译 器 (Builders) ， 我 们 可 以 借助 这 个 功能 来 为 NDK 项 目 配 
置 自动 化 编译 的 功能 。 


右键 单 击 Hellojni 项 目 ， 在 打开 的 下 拉 菜 单 中 选择 项 目的 Properties (属性 ) 选项 ， 打 开 项 目 配置 窗口 。 然 后 选中 左边 配置 列表 中 的 Builders 选 项 ， 在 右边 窗口 中 可 以 看 到 已 经 存在 的 编译 器 ， 包 括 
Android Resource Manager (Android 资 源 管 理 器 ) 和 Android Pre Compiler (代码 编译 器 ) 等 ， 如 图 12-9 所 示 。 接 着 点 击 右边 的 “New” 按钮 来 为 HellojJni 项 目 创建 NDK 编 译 器 。 
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图 12-9 创建 NDK 编 译 器 


接 下 来 ， 需 要 选择 编译 器 类 型 ， 我 们 选择 Program 即 可 ， 如 图 12-10 所 示 。 
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图 12-10 选择 编译 器 类 型 


接着 进入 Builder 的 详细 配置 界面 ，Name 处 填写 Hellojni_Builder，Location 参 数 填 入 NDK 目 录 下 的 ndk-build.cmd 工 具 的 路 径 (可 使 用 “Browse File System” 选择 ) , Working Directory 中 填写 
HelloJni 项 目的 路 径 (可 使 用 “Browse Workspace” 选择 ) ， 如 图 12-11 所 示 。 
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图 12-11 编译 器 主要 配置 界面 


然后 ， 选 中 “Build Options” 标 签 , 把 “Run the builder" 下面 的 选项 都 勾 选 上 ， 如 图 12-12 所 示 。 接 着 选中 “Specify working set of relevant resources” 选项 ， 并 点 击 右边 的 “Specify 
Resources” 按 钮 打开 Edit Working Set (资源 选择 ) 窗口 ， 如 图 12-12 所 示 。 


我 们 在 Edit Working Set 窗 口中 选中 HelloJni 项 目下 的 jni 目 录 ， 让 编译 器 知道 需要 编译 的 文件 所 在 的 目录 ， 如 图 12-13 所 示 。 


全 部 配置 完成 后 ， 我 们 会 在 原先 的 Builders 界 面 中 看 到 创建 完毕 的 Hellojni_Builder 编 译 器 ， 单 击 “OK” 关 闭 项 目 配置 窗口 。 一 般 来 说， 此 时 Eclipse 就 会 自动 开始 编译 项 目 了 ， 图 12-14 就 是 编译 完成 后 
打印 出 的 结果 信息 ， 我 们 看 到 编译 完成 的 libhello-jni.so 文 件 被 保存 到 libs/armeabi/ 目 录 下 。 
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图 12-12 ”编译 器 选项 配置 界面 
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图 12-13 ”选择 需要 编译 的 文件 


ER ee [Proaran] D \android-ndi-r7 indi-build. ond 
|Odbascrwer r [arm-linux-androidcabi-4.4.3] libs/armnmcabi/gdbscrwcer 


Cdbservp * libz/armeabi/adb.zsetup 


"Compile thumb : hello-jni <= bello-jni.c 


SnaredLibrary z libhellc-jni.süa 
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Install t libhello-jni.so => libs/armcabi/libhcll1o-jni. sd 


图 12-14 ”编译 完成 后 的 结果 信息 


最 后 , 使 用 “Run As” 中 的 “Android Application" 安装 Hellojni 项 目 到 Android 模 拟 器 上 ， 项 目的 最 终 运 行 效果 如 图 12-15 所 示 。 这 里 我 们 就 可 以 看 到 由 stringFromJNI 接 口 返回 的 “Hello from 
”字符 串 了 。 


图 12-15 NDK 项 目的 运行 效果 


至 此 ， 首 个 NDK 项 目 HelloJni 已 经 圆满 完成 ， 大 家 应 该 对 Android NDK 开 发 有 了 


体 的 实践 经 验 ， 相 信 这 对 大 家 深入 学 习 Android NDK 开 发 是 很 有 益处 的 。 


本 章 主要 讲述 了 Android NDK: 
相关 知识 。 虽 然 ， 目 前 NDK 还 处 于 


发 的 相关 知识 ， 从 NDK 开 发 的 基础 理论 到 实际 运 上 


， 包 括 了 核心 编译 脚本 Android.mk 和 Application.mk 的 使 用 ，NDK 开 发 环境 的 搭建 ， 以 及 建立 首 个 NDK 实 例 项 目的 
F 初 级 阶段 ， 但 是 已 经 受到 广大 开发 者 的 欢迎 。 另 外 ，NDK 开 发 还 是 Android 游 戏 开发 的 基础 ， 所 以 这 部 分 内 容 也 是 比较 重要 的 。 


前 面 我 们 重点 介绍 了 与 Android 应 
进行 Android 应 用 的 界 


开发 相关 的 内 容 ， 侧 重 了 


H 


能 使 用 UI 控 件 来 实现 。 习 


介绍 如 何 通过 服务 端 和 客户 端的 配合 来 开发 Android 移 动 互联 网 应 用 。 期 间 我 们 还 学 习 了 如 何 使 
开发 ， 但 是 如 果 要 在 Android 系 统 内 开发 游戏 的 话 ， 这 些 知识 还 远 不 能 满足 我 们 的 需求 。 众 所 周知 ， 游 戏 界面 要 比 应 用 界面 
8 么 我 们 该 如 何 入 手 呢 ? 本 章 就 将 带领 大 家 进入 Android 游 戏 开发 的 世界 。 


Android 应 用 框架 提供 


的 UI 布局 和 UI 控件 
灵活 和 复杂 得 多 ， 也 不 遵循 应 用 的 UI 布 


局 ， 当 然 更 不 可 


手 游 ， 即 手机 游戏 ， 是 近 生 


来 游戏 产业 中 出 现 的 新 名 词 


， 我 们 经 常 把 手 游 当 做 所 有 移动 端 游 戏 的 统称 。 虽 然 出 现时 间 不 长 ， 但 是 手 游 产 业 发 展 至 今 已 经 出 现 了 巨大 的 突破 ， 越 来 越 多 的 用 户 开始 习惯 在 
手机 上 玩 游戏 ， 各 大 应 用 市 场 上 充满 着 琳琅 满目 的 手 游 应 用 ， 甚 至 连 一 些 大 型 的 PC 游戏 也 纷纷 
感叹 手 游 产 业 的 发 展 之 快 。 


推出 手 游 版 ， 可 以 说 手 游 产 业已 经 迎 来 了 大 爆发 的 时 代 。 回 顾 在 手机 


上 玩 贪 食 蛇 、 弹 跳 球 的 时 期 ， 我 们 不 得 不 
然而 ， 通 过 分 析 我 们 不 难看 出 ， 手 游 产 业 的 高 速 发 
国 智能 手机 


户 已 经 过 亿 ， 其 中 大 部 分 设备 使 


展 离 不 开 智能 移动 平台 的 出 现 ， 从 近 几 全 


F 的 发 展 趋势 来 看 尤为 明显 ， 而 Android 平 台 恰巧 就 是 智能 移动 平台 中 的 佼佼 者 。 据 可 靠 数 据 统 计 ，2012 
的 操作 系统 就 是 Android 平 台 ; 毫 无 疑问 ， 在 接 下 来 的 几 年 内 ，Android 平 台 的 用 户 量 还 会 稳步 增加 ， 因 


F 中 


此 Android 手 游 的 


和 场 必 将 是 无 比 广 冰 的 。 


与 Android 应 用 开发 不 同 ，Android 游 戏 开 发 的 思路 更 类 似 了 
可 以 根据 用 户 的 操作 不 断 变化 。 实 际 上 ， 游 戏 产业 发 
来 分 析 一 下 手 游 开 发 中 的 几 个 要 素 。 


传统 的 画图 


RES, Kef 


程序 ， 简 单 来 说 ， 就 是 通过 控制 程序 逻辑 在 画布 (Canvas) 组 件 上 作画 的 过 程 。 只 不 过 这 些 画 有 的 是 2D 的 ， 有 的 是 3D 的 ， 并 1 
的 基本 原理 还 是 没有 改变 的 。 但 是 ， 原 理 虽 然 简单 ， 开 发 起 来 却 并 不 简 和 


is 
;为 了 便于 大 家 理解 ， 下 面 我 们 将 按照 MVC 设 计 模 式 的 思路 


MYVC 的 概念 大 家 应 该 都 非常 熟悉 了 ， 之 前 介绍 Android 应 用 的 客户 端 以 及 服务 端 编程 的 时 候 ， 我 们 都 提 及 了 MVC 软 件 设计 模式 。 对 于 游戏 程序 来 疝 ， 尤 其 是 比较 大 型 的 游戏 程序 ， 一 般 也 都 会 遵循 
MVC 的 设计 理念 ， 简 要 分 析 如 下 。 


1. 模 型 层 (Model) 


对 于 游戏 来 说 ， 模 型 层 显然 不 仅仅 包括 数据 模型 还 需要 包含 资源 相关 的 模型 ， 比 如 人 物 、 图 片 、 动 画 等 。 对 于 没有 使 用 游戏 引擎 的 游戏 程序 来 说 ， 我 们 不 得 不 去 考虑 这 些 问题 ， 这 部 分 内 容 在 13.1.2 
节 中 的 两 个 游戏 实例 中 可 以 了 解 到 ， 这 里 暂 不 深究 。 


2. 显 示 层 (View 


在 Android 系 统 中 ， 我 们 通常 会 使 用 View 或 者 SurfaceView 视 图 控件 来 作为 游戏 画布 (Canvas) 的 底层 视图 。 以 下 内 容 将 分 别 对 这 两 种 视图 的 用 法 进行 详细 介绍 。 


重 写 View 类 中 的 onDraw 方 法 来 实现 。 使 用 范例 如 代码 清单 13-1 


View 类 是 所 有 视图 类 的 超 类 ， 每 个 View 类 都 有 自己 的 Canvas 画 布 对 象 ， 可 供 我 们 自由 使 用 和 扩展 。 至 于 绘制 画布 的 逻辑 ， 则 需要 通 i 
所 示 。 


代码 清单 13-1 


public class GameViewDemo extends View 


public GameViewDemo (Context context) ( 
super (context) ; 
} 
public void onDraw (Canvas canvas) { 
// 绘图 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


SurfaceView 是 Android 系 统 中 的 一 个 非常 重要 的 绘图 容器 ， 其 特点 是 可 以 在 主线 程 之 外 的 线程 中 进行 屏幕 绘图 ， 因 此 要 比 View 更 适合 游戏 开发 。 之 前 11.4 节 中 介绍 摄像 头 使 用 的 时 候 就 提 及 过 
SurfaceView 的 相关 内 容 ， 但 是 ， 真 正 能 让 SurfaceView 发 挥 其 所 长 的 地 方 还 是 在 游戏 应 用 中 。 对 于 界面 元 素 比较 丰富 的 游戏 ， 每 个 元 素 都 有 自己 的 动作 逻辑 ， 使 用 View 来 实现 的 话 ， 每 次 都 要 进行 全 局 计 
算 并 刷新 全 屏 ， 这 显然 是 不 合理 的 。 使 用 SurfaceView 的 话 就 可 以 把 界面 元 素 分 为 独立 的 Surface 来 处 理 ， 这 种 处 理 方式 显然 效率 更 高 。 在 游戏 开发 中 ， 我 们 通常 会 把 不 同 的 Surface 称 作 “ 物 件 ”。 


使 用 SurfaceView 的 时 候 需要 对 其 对 象 的 创建 、 改 变 、 销 毁 等 各 个 情况 进行 监视 ， 我 们 可 以 通过 SurfaceHolder.Callback 接 口 来 实现 。 另 外 ， 我 们 还 可 以 使 用 SurfaceHolder 类 来 控制 视图 中 各 个 
SurfaceView 的 形态 和 动作 。SurfaceHolder 类 可 通过 getHolder 方 法 来 获取 ， 该 类 还 提供 了 addCallback 来 设置 SurfaceHolder.Callback 接 口 。 最 后 ， 我 们 把 SurfaceView 类 的 常用 方法 总 结 如 下 。 


- surfaceChanged: Surface 发 生 改 变 时 调用 。 

- surfaceCreate: Surface 被 创建 时 调用 。 

: surfaceDestoryed: Surface 被 销毁 时 调用 。 

- addCallback: 为 SurfaceView 添 加 SurfaceHolder.Callback 接 口 实 现 。 
“lockCanvas: 锁定 画布 ， 使 用 画布 (Canvas) 对 象 前 必须 先 锁定 。 
: unlockCanvasAndPost: 解锁 画布 ， 画 布 绘制 完成 之 后 解锁 。 


- removeCallback: 移 除 SurfaceHolder.Callback 接 口 实现 。 


另外 ， 在 使 用 SurfaceView 进 行 绘图 时 ， 必 须 先 使 用 lockCanvas 方 法 来 锁定 画布 ， 并 得 到 画布 对 象 ， 绘 制 完 成 之 后 再 使 用 unlockCanvasAndPost 方 法 进行 解锁 。 使 用 范例 如 代码 清单 13-2 所 示 。 


代码 清单 13-2 


class GameSurfaceViewDemo extends SurfaceView implements SurfaceHolder.Callback, Runnable 
{ 
// Surface 控 制 对 象 
SurfaceHolder sh = null; 
// 控制 循环 ， 开始 需 设置 为 true 
boolean isLoop = false; 
public GameSurfaceViewDemo (Context context) { 
super (context); 
sh = getHolder(); 
sh.addCallback (this) ; 


l 
GOverride 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) ( 
// Surface 改 变 时 的 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 

GOverride 

public void surfaceCreated(SurfaceHolder holder) ( 
// Surface 创 建 时 的 逻辑 
new Thread(this).start(); 


} 
GOverride 
public void surfaceDestroyed(SurfaceHolder holder) { 
// Surface 销 毁 时 的 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 
public void doDraw(Canvas canvas) { 
super.onDraw (canvas) ; 
// 绘图 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 
public void run() { 
// 线程 开始 
while (isLoop) { 
try { 
Canvas canvas = sh.lockCanvas(); 
doDraw (canvas) ; 
sh.unlockCanvasAndPost (canvas) ; 
Thread.sleep (100) ; 
} catch (Exception e) { 
} 


GameSurfaceViewDemo 类 继承 自 SurfaceView 类 并 实现 了 SurfaceHolder.Callback 和 Runnable 接 口 。 其 中 surfaceChanged、surfaceCreated 以 及 surfaceDestroyed 方 法 属于 
SurfaceHolder.Callback 接 口 ， 主 要 用 于 控制 Surface 改 变 时 的 动作 ;而 run 方 法 则 属于 Runnable 接 口 ， 这 里 包含 了 Surface 的 绘图 逻辑 。 此 外 ，surfaceCreated 方 法 中 开启 了 新 线程 ， 用 于 不 断 重 绘 当前 
Surface 物 件 ， 而 真正 的 绘图 逻辑 则 被 放置 于 doDraw 方 法 中 。 


3. 逻 辑 控制 器 层 (Control) 


前 面 已 经 介绍 了 使 用 View 和 SurfaceView 视 图 类 进行 Android 游 戏 开发 的 方法 ， 其 中 也 已 经 包含 了 部 分 的 控制 逻辑 。 但 是 ， 在 Android 系 统 中 ， 我 们 还 是 需要 通过 界面 控制 器 ， 也 就 是 Activity 类 来 进行 
UI 界面 显示 。 因 此 ， 不 管 使 用 View 还 是 SurfaceView， 都 需要 把 控制 逻辑 整合 到 Activity 类 中 去 。 


首先 ， 重 绘 View 视 图 需要 使 用 View 类 的 invalidate 方 法 ， 该 方法 既 可 用 于 重 绘 整个 视图 ， 也 可 用 于 更 新 视图 中 的 部 分 区 域 。 需 要 注意 的 是 ，invalidate 方 法 不 可 以 在 主线 程 中 直接 调用 ， 常 见 的 用 法 是 
在 消息 处 理 器 Handler 的 handleMessage 方 法 中 进行 调用 ; 当然 ， 也 可 以 使 用 postlnvalidate 方 法 直接 在 当前 线程 中 调用 。 以 之 前 介绍 的 GameViewDemo 为 例 ，Activity 类 的 逻辑 整合 范例 如 代码 清单 13-3 
所 示 。 


代码 清单 13-3 


public class GameViewActivity extends Activity 


// 处 理 器 消息 

private static final int REFRESH = 1; 

// 游戏 主要 对 象 

private GameViewDemo gameViewDemo = null; 

private Handler gameViewHandler = null; 

// 控制 循环 ， 开 始 需 设 置 为 true 

boolean isLoop = false; 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
// 初始 化 视图 
gameViewDemo = new GameViewDemo (this) ; 
setContentView (gameViewDemo) ; 
// 初始 化 处 理 器 
gameViewHandler = new GameViewHandler () ; 
// 开启 游戏 线程 


new Thread (new GameViewTask()).start(); 


} 
GOverride 
protected void onPause() ( 
// 游戏 暂停 逻辑 
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private class GameViewHandler extends Handler { 
GOverride 
public void handleMessage (Message msg) ( 
switch (msg.what) ( 
case GameViewActivity.REFRESH: 
gameViewDemo.invalidate(); 
break; 
} 
f 


private class GameViewTask implements Runnable { 
public void run() { 
while (isLoop) { 
// 发 送 刷新 消息 
Message m = new Message () ; 
m.what = GameViewActivity.REFRESH; 
gameViewHandler.sendMessage (m) ; 
// 若 想 使 用 直接 刷新 View 视 图 的 用 法 ， 可 先 注释 掉 前 一 行 的 代码 ， 同 时 打开 下 一 行 的 注释 
gameViewDemo.postInvalidate(); 
// 循环 间隔 
Thread.sleep (100) ; 
} 
} 
} 
public boolean onTouchEvent (MotionEvent e) { 
// 操作 控制 逻辑 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 


我 们 可 以 重点 观察 GameViewActivity 类 中 的 onCreate 方 法 的 逻辑 ， 以 及 GameView-Handler 消 息 处 理 器 类 和 GameViewTask 线 程 类 的 实现 。 总 体 思路 还 是 比较 简单 的 ， 游 戏 界 面 初始 化 之 后 ， 就 会 开 
启 游戏 线程 ， 不 断 重 绘 View 视 图 。 然 后 ， 我 们 就 可 以 在 类 似 onTouchEvent 的 方法 中 捕获 用 户 的 动作 ， 并 控制 View 视 图 进行 改变 。 当 然 ， 游 戏 暂停 时 ， 我 们 还 需要 在 onPause 方 法 中 添加 相应 的 逻辑 。 


相对 来 阅 ，SurfaceView 与 Activity 类 逻辑 的 耦合 度 更 加 松散 ， 因 为 每 个 Surface 物 件 都 有 自己 独立 的 线程 。 通 常情 况 下 ， 主 要 逻辑 都 会 被 放 在 SurfaceView 类 的 线程 类 或 方法 中 ， 比 如 之 前 提 到 的 
GamesurfaceViewDemo 类 (如 代码 清单 13-2 所 示 ) 中 的 run 方 法 。 当 然 ， 更 清晰 的 做 法 是 声明 一 个 线程 类 ， 比 如 叫 GameSurfaceViewTask， 并 把 游戏 逻辑 放 到 其 中 ， 实 际 上 13.1.2 节 的 飞船 游戏 实例 就 
是 这 样 做 的 。 


13.1.2 “” 贪 食 蛇 和 飞船 游戏 实例 


在 上 节 中 ， 我 们 从 MVC 设 计 模式 的 角度 介绍 了 Android 手 游 开 发 中 的 几 个 重要 因素 ， 让 大 家 从 一 定 程度 上 了 解 了 在 Android 平 台 上 进行 游戏 开发 的 思路 。 具 体 来 说 ， 包 括 使 用 View 和 SurfaceView 来 实 
现 的 两 种 思路 。 接 下 来 我 们 将 通过 两 个 游戏 实例 ， 继 续 给 大 家 讲解 这 两 种 开发 思路 的 实际 应 


事实 上 ，Android SDK 自 带 的 例子 中 已 经 提供 了 两 个 非常 好 的 例子 ， 也 就 是 贪 食 蛇 和 飞船 游戏 ， 这 两 个 实例 分 别 代 表 了 使 用 View 和 SurfaceView 进 行 游戏 开发 的 两 种 思路 。 首 先 ， 我 们 来 尝试 导入 游戏 
的 代码 并 运行 游戏 。 在 Eclipse 中 ， 打 开 新 Android 项 目的 创建 向 导 ， 选 择 指 定 的 Android SDK 版 本 ， 比 如 Android 2.2， 然 后 再 选中 “Create project from existing sample" 选项， 我 们 就 可 以 在 Samples 
的 下 拉 框 中 看 到 贪 食 蛇 和 飞船 游戏 的 实例 项 目 了 (分别 是 Snake 和 JetBoy) ， 如 图 13-1 所 示 。 接 着 ， 单 击 Finish 按 钮 就 可 以 导入 相应 的 项 目 了 。 


小 贴 士 : 图 13-1 是 在 ADT 12.0.0 版 本 中 Android 范 例 项 目的 创建 过 程 ， 不 过 在 最 新 的 ADT 版 本 中 ， 创 建 流程 稍 有 不 同 。 比 如 ， 在 20.0.0 以 上 的 版 本 中 ， 我 们 需要 选择 Eclipse 的 “New Project” 菜 单 中 


的 “Android Sample Project” 选 项 来 创建 范例 项 目 。 


项 目 导入 完成 之 后 ， 我 们 就 可 以 在 Android 模 拟 器 上 运行 游戏 实例 。 首 先 ， 我 们 来 看 一 下 贪 食 蛇 游戏 ， 图 13-2 就 是 该 游戏 的 运行 效果 。 
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图 13-1 创建 伪 食 蛇 游 戏 项 目 


5:23 


— 
— 


yl ui! G t 


ü 


贪 食 蛇 游戏 的 项 目 名 为 Snake， 


由 于 源 代 码 比较 长 ， 


1.Snake 类 


贪 食 蛇 游戏 的 界 下 


的 操作 。 


2.TileView 类 


贪 食 蛇 游戏 的 基础 视 


控制 器 ， 继 承 


四 


继承 


自 Activity 类 。 我 们 需要 


辑 。 


3.SnakeView 类 


贪 食 蛇 游戏 的 主 


继承 


类 ， 


要 视图 


从 贪 食 蛇 游戏 中 


SurfaceView 视 


可 以 击 爆 陨石 ， 在 固 


自 TileView 类 。 该 类 主 
了 一 个 消息 处 理 器 类 RefreshHandler， 用 于 处 理 SnakeView 的 刷新 动作 。 


点 关注 onCreate 方 法 中 的 初始 化 逻辑 ， 以 及 onPause 方 法 中 的 暂停 逻辑 。 实 际 上 ， 这 些 逻 辑 也 都 是 对 游戏 视 医 


图 13-2 PRII RRITAR 


主要 程序 代码 在 com.example.android.snake 下 ， 包 含 了 Snakejava、SnakeViewjava 以 及 TileView.java 这 3 个 文件 ， 分 别 对 应 了 Snake、SnakeView 和 TileView 类 。 
限于 篇 幅 ， 这 里 就 不 进行 逐 行 讲解 了 ， 接 下 来 介绍 代码 的 主要 逻辑 ， 大 家 可 对 照 源码 进行 理解 。 


类 的 SnakeView 对 象 进行 相应 


自 View 类 ， 包 含 了 对 贪 食 蛇 游戏 界面 显示 的 基础 方法 ， 这 些 方法 大 部 分 都 和 资源 加 载 有 关 。 另 外 ，TileView 类 中 还 实现 了 View 类 的 onDraw 方 法 ， 定 义 了 重 绘 的 基本 逮 


是 针对 


户 输入 进行 逻辑 处 理 。 比 如 ， 按 下 键盘 右键 时 界 如 何 显示 ， 或 者 当 蛇 身 碰 到 边界 时 会 有 什么 样 的 反应 等 。 另 外 ,该 类 中 还 包含 


E 


， 我 们 可 以 学 到 使 


定时 间 


内 ， 击 爆 的 


类 进行 游戏 


View 视 图 


。 下面 我 们 就 以 飞船 游戏 为 例 来 讲解 使 用 SurfaceView 进 行 游戏 


发 的 方法 ， 但 是 这 种 方式 仅仅 适合 于 那些 简单 游戏 ， 对 于 一 些 界面 相对 复杂 、 物 件 比 较 丰富 的 游戏 来 说 就 力不从心 了 。 这 时 我 们 就 需要 使 用 
发 的 思路 。 飞 船 游戏 的 运行 效果 如 图 13-3 所 示 ， 操 作 方法 比较 简单 ， 在 陨石 靠近 飞船 时 按 下 “发 射 ”按钮 ， 就 


飞船 游戏 的 项 目 


名 为 JetBoy, 4 


图 13-3 飞船 游戏 运行 效果 


EF 要 程序 代码 在 com.example.android.jetboy 下 面 ,包含 了 Asteroid.java、Explosion.java、JetBoy.java 以 及 JetBoyView.java 这 4 个 文件 ， 分 别 对 应 了 Asteroid、 


Explosion、JetBoy 和 JetBoyView 类 ， 而 游戏 的 核心 代码 就 在 JetBoy 和 JetBoyView 类 中 。 由 于 源 代码 比较 长 ， 限 于 篇 幅 ， 这 里 就 不 详细 介绍 了 ， 代 码 的 主要 逻辑 如 下 所 示 ， 大 家 可 对 照 源码 进行 理解 。 


1.JetBoy 类 


飞船 游戏 的 界面 


这 些 逻 辑 是 放 在 snakeView 视 图 类 里 面 的 ， 那 是 因 


控制 器 ， 继 承 


自 Activity 类 。 该 类 的 作用 和 贪 食 蛇 游 戏 的 Snake 类 比较 相似 ， 主 要 用 于 初始 化 飞船 游戏 的 视 匿 


2.JetBoyView 类 


飞船 游戏 的 主 


视图 类 ， 继 承 


解 事件 驱动 编程 模式 


H 


JetBoyThread 类 的 实现 思路 和 
t 事 件 传递 到 JetBoyThread 类 的 事件 队列 中 ， 然 后 程序 就 会 不 停 地 从 队列 中 获取 事件 并 进行 处 理 ， 相 关 风 辑 可 参考 updateGameState 方 法 。 另 外 值得 注意 的 是 ， 这 里 还 用 到 了 
有 件 队 列 ， 当 然 ， 该 队列 是 线程 安全 的 。 


会 被 当做 GameEven 


ConcurrentLinkedQueue 无 界 队 列 来 存储 对 


自 SurfaceView 类 ， 同 时 实现 了 SurfaceHolder.Callback 接 口 。 该 类 的 逻辑 比较 复杂 ， 涉 及 的 
的 思路 。 建 议 大 家 以 GameEvent 类 和 JetBoyThread 类 为 主线 来 进行 代码 解读 。 


RJE 


介绍 的 GamesurfaceViewDemo 类 (如 代码 清单 13-2 所 示 ) 比较 类 似 ， 主 要 的 绘 医 


为 贪 食 蛇 游戏 的 整个 界面 是 一 体 的 ， 然 而 飞船 游戏 则 不 是 这 样 ， 


和 物件 ， 不 同 之 处 在 于 该 类 还 捕获 了 用 户 的 操作 。 在 之 前 的 贪 食 蛇 游戏 中 ， 
户 操作 的 逻辑 放 在 界面 控制 类 中 会 相对 比较 合理 些 。 


因此 把 捕获 有 


H 


内 容 也 比较 多 ， 我 们 除了 需要 了 解 SurfaceView 的 使 用 方法 之 外 ， 还 需要 理 


户 的 所 有 操作 都 


逻辑 在 doDraw 方 法 中 。GameEvent 是 所 有 游戏 事件 的 基 类 ， 


至 此 ， 我 们 已 经 分 析 了 贪 食 蛇 和 飞船 游戏 这 两 个 游戏 实例 ， 也 完成 了 Android 手 游 开发 从 理论 到 实践 的 过 渡 。 限 于 篇 幅 ， 之 前 只 是 分 析 和 介绍 了 游戏 程序 逻辑 实现 中 的 要 点 ， 并 没有 对 


进行 详细 介绍 。 


体 的 代码 逻辑 


此 ， 这 里 建议 大 家 顺 着 MVC 设 计 模式 的 思路 ， 参 考 之 前 提 到 的 要 点 分 析 ， 对 以 上 两 个 游戏 的 代码 进行 深入 研读 ， 这 可 以 帮助 我 们 更 好 地 理解 Android 手 游 开 发 的 思路 。 


13.1.3 认识 Android 游 戏 引 擎 


在 上 节 内 容 中， 通过 对 贪 食 


了 ， 但 是 假如 我 人 


成 代码 的 混乱 ， 比 如 在 飞船 游戏 实例 中 ， 主 要 逻辑 都 被 放 到 了 JetBoyView 类 中 ， 包 括 资源 加 载 、 事 件 处 理 等 ， 阅 读 起 来 会 让 人 感觉 很 累 。 随 着 游戏 产业 的 不 断 发 展 ， 游 戏 产品 也 变 得 越 来 越 复 杂 ， 同 时 玩家 


E 和 飞船 游戏 这 两 个 游戏 实例 的 介绍 ， 我 们 已 经 学 习 了 使 用 View 和 SurfaceView 来 进行 Android 游 戏 开发 的 两 种 不 同 的 思路 ， 对 于 普通 的 小 游戏 来 说 ， 这 些 知识 已 经 够 


] 把 类 似 的 思路 


在 一 些 中 大 型 游戏 中 ， 却 会 产生 很 大 的 问题 。 主 要 原因 是 之 前 的 开发 方法 把 所 有 逻辑 都 放 到 了 View 或 者 SurfaceView 的 子 类 里 面 ， 这 样 当 程序 逻辑 逐渐 变 得 复杂 时 极 易 造 


S2 


对 游戏 的 要 求 也 在 逐步 提高 ， 为 了 应 对 这 些 问题 和 压力 ， 游 戏 引擎 便 应 运 而 生 。 


引擎 (engine) 的 概念 最 先 源 于 机 械 工 业 ， 指 的 是 发 动机 系统 的 核心 部 分 ， 主 要 用 于 给 机 械 设 备 提供 动力 。 后 来 ， 引 警 的 概念 被 引入 到 IT 工业 中 ， 搜 索引 擎 、 
对 于 游戏 产业 来 说 ， 我 们 通常 会 把 所 有 与 游戏 制作 过 程 有 关 的 模块 组 件 统称 为 游戏 引擎 。 我 们 通常 把 引擎 比喻 成 机 械 设备 的 心脏 ， 而 游戏 引擎 在 游戏 产品 中 的 地 位 


游戏 自身 的 性 能 。 


了 解 游戏 引擎 首先 需要 从 游戏 本 身 入 手 ， 游 戏 产业 发 展 至 今 ， 已 经 出 现 了 繁多 的 游戏 类 型 。 根 据 游戏 画面 划分 ， 主 要 有 2D 游 戏 和 3D 游 戏 两 种 ; 根据 内 容 来 分 类 ， 则 包括 


D 


形 引 擎 、 物 理 引 擎 等 也 就 随 之 出 现 了 。 


a) 


同样 重要 ， 游 戏 引擎 的 好 坏 直接 决定 了 


JIA 


色 扮 演 游戏 (RPG) 、 动 作 游 


戏 (ACT) 、 冒 险 游戏 (AVG) 、 策 略 游戏 (SLG) 、 及 时 战略 游戏 (RTS) 、 格 斗 游戏 (FTG) 、 射 击 游戏 (STG) 以 及 益 智 类 游戏 (PZL) 等 。 虽 然 不 同类 型 的 游戏 都 有 各 自 的 特色 ， 但 是 大 部 分 的 游戏 


都 必须 要 考虑 到 操作 捕获 、 图 形 建 模 、 光 影 效 果 、 物 理 碰撞 、 音 效 输出 以 及 资源 管理 等 问题 ， 这 些 公 
就 是 游戏 引擎 的 主要 组 成 部 分 ， 下 面 我 们 来 逐个 介绍 。 


iR 


形 引擎 


的 部 分 也 就 是 游戏 引 警 需要 关注 的 内 容 。 实 际 上 ， 游 戏 引 警 就 是 上 述 功能 模块 的 集合 ， 图 13-4 所 示 的 


游戏 引擎 


图 13-4 游戏 引擎 的 主要 组 成 


合 ， 根 据 不 同 的 游戏 类 型 ， 大 致 可 


2. 物 理 引擎 


游戏 中 通常 需要 模拟 一 些 现实 的 场景 ， 比 如 物体 碰撞 、 石 块 掉 落 、 炸 药 爆炸 等 。 早 期 的 时 候 ， 我 们 只 能 通过 行为 脚本 和 固 


种 状况 。 物 理 引擎 使 


对 象 属性 (uj 


到 形 引擎 应 该 是 游戏 引擎 的 关键 ， 不 管 是 什么 类 型 的 游戏 ， 画 面 无 疑 是 最 重要 的 因素 之 一 ， 流 畅 的 显示 和 绚丽 的 效果 往往 是 游戏 吸引 玩家 的 一 大 利器 。 简 单 来 说， 图 形 引 警 是 一 系列 图 形 、 效 果 类 的 集 


分 为 2D 和 3D 两 种 。 另 外 ， 不 同 的 游戏 引擎 都 会 有 自己 的 图 形 引 擎 ， 因 此 这 部 分 内 容 的 学 习 成 本 可 能 会 比较 高 。 


Bez 


定 的 动画 效果 来 模拟 ， 但 是 这 种 方式 显然 不 够 真实 ， 物 理 引擎 的 出 现 改变 了 这 


业内 常见 的 2D 物 理 引 


小 贴 士 : 在 物理 
ARE. 
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量 、 扭 矩 、 弹 性 等 ) 来 模拟 刚体 、 流 体 的 行为 ， 使 用 物理 引擎 不 仅 可 以 得 到 更 加 真实 的 结果 ， 对 于 开发 人 员 来 说 也 会 更 加 容易 掌握 。 物 理 引 警 也 分 为 2D 和 3D 两 种 ， 目 前 


擎 有 Box2D， 而 3D 物 理 引擎 则 有 Havok、PhysX 等 ， 限 于 篇 幅 这 里 就 不 详细 介绍 了 ， 有 兴趣 的 读者 可 自行 研究 。 


定义 在 任何 力 的 作用 下 体积 和 形状 都 不 发 生 改 变 的 物体 叫 作 刚 体 (Rigid Body) 。 刚 体 是 力学 中 的 一 个 抽象 概念 ， 即 理想 模型 。 事 实 上 任何 物体 受到 外 力 后 ， 形 状 都 要 发 


3. 脚 本 引擎 


脚本 引 丈 的 作用 在 于 增强 程序 的 可 配置 性 ， 不 管 是 应 用 还 是 游戏 都 需 


些小 改动 变 得 非常 困难 。 为 了 让 程序 变 得 


小 贴 士 : Lua 是 一 个 小 巧 的 脚本 语言 。 
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音效 引擎 用 于 处 理 游戏 中 的 音效 ， 简 和 


5. 工 具 模块 


一 个 成 熟 的 游戏 引擎 一 般 都 会 有 自己 的 工 


目前 在 PC 游戏 领域 ， 常 见 的 2D 游 戏 引 擎 有 Torque2D、Smart2D、Cocos2d 等 ， 而 3D 游 戏 引擎 中 
水 起 的 Bigworld 引 警 等。 不 过 ， 这 些 引擎 通常 都 被 


小 贴 士 : MMOG (Massive Multiplayer Online Game， 大 型 多 人 在 线 游戏 ) 是 目前 最 流行 的 网 络 游戏 类 型 ， 通 常 分 为 以 下 几 
` MMORPG， 即 大 型 多 人 在 线 角色 扮演 游戏 。 

© MMOFPS， 即 大 型 多 人 在 线 第 一 人 称 射击 游戏 。 

© MMORTS， 即 大 型 多 人 在 线 即 时 战略 游戏 。 


相对 于 PC 游戏 ， 目 前 手 游 界 的 游戏 引擎 还 处 于 发 


细 介 绍 。 


13.14 使 用 OpenGL 和 OpenGL ES 


OpenGL (Open Graphics Library) 定义 了 一 个 跨 语言 、 跨 平台 的 编程 
到 人 能源、 娱乐 、 游 戏 开 发 、 制 造 业 、 制 药 业 及 虚拟 现实 等 行业 领域 中 ， 诞 生 至 今 已 催生 了 大 量 的 各 种 计算 机 平台 及 设备 上 的 优秀 应 用 程序 。 


从 1992 年 7 月 ，SGI 公 司 发 布 了 OpenGL 的 1.0 版 本 ， 到 
成 熟 也 极 大 地 影响 了 OpenGL 的 发 展 速度 。 不 过 随 着 Android、iOS 等 智能 操作 系统 的 4 


OpenGL ES (OpenGL for Embedded Systems) 是 OpenGL 图 形 API 的 子 集 ， 是 针对 手机 、PDA 和 游戏 
边 形 (GL QUADS) 、 多 边 形 (GLPOLYGONS) 等 
1.x 针 对 的 是 固定 管线 硬件 ， 其 中 OpenGL ES 1.0 以 OpenGL 1.3 规 范 为 基础 ， 而 OpenGL ES 1.1 则 是 以 OpenGL 


OpenG| 裁 剪 定制 而 来 的 ， 去 除了 glBegin/glEnd、 


更 加 灵活 ， 也 更 易于 扩 


其 设计 目的 是 浴 入 应 用 


开发 大 型 游戏 ， 对 了 


模块 。 其 中 主要 包括 两 方面 内 容 ， 一 是 开发 相关 的 工 


到 脚本 ， 对 于 大 型 游戏 来 说 ， 程 序 代码 通常 都 是 由 
展 ， 我 们 通常 需要 一 些 脚 本 进行 “混合 式 ” 开 发 。 比 如 ， 实 际 项 目 中 就 经 常 


来 说 就 是 控制 声音 的 播放 ， 不 过 在 某 些 大 型 3D 游 戏 中 ， 为 了 达到 更 逼真 的 效果 ， 


大 量 的 C 和 C++ 代码 和 类 库 所 构成 的 ， 


由 于 源码 改动 的 成 本 非常 高 ， 这 让 一 


到 Lua 脚 本 进行 开发 。 


程序 中 ， 从 而 为 应 用 程序 提供 灵活 的 扩展 和 定制 功能 。Lua 由 标准 C 语 言 编写 而 成 ， 几 乎 在 所 有 操作 系统 和 平台 上 都 可 以 编译 和 运行 。 


集 ， 比 如 一 些 绘 轿 


效 引擎 可 能 需要 与 物理 引 


比较 著名 的 有 Epic 公 司 
F 相 对 小 巧 的 手 游 来 说 却 并 不 适合 。 


居 物 件 的 实时 状态 ， 动 态 地 创建 音效 。 


以 及 3D Max. Maya T. 


插件 等 ; 二 是 工具 类 库 ， 比 如 网 络 相关 的 工具 类 等 。 


的 Unreal 虚 幻 系列 引擎 、Crytek 公 司 的 CryEngine 引 警 以 及 在 MMOG 市 场 风 生 


中 类 型 : 


至 


后 来 的 OpenGL 1.5. OpenGL 2.0, 


= 


H 现 、 智 能 移动 软件 让 


前 OpenGL 3.0 的 出 现 ，OpenGL 的 发 


EU 


IDEAR 


FRANEA, iZAPIERKhronosfEBI 


杂 图 元 的 许多 非 绝 对 必 


展 历程 经 历 了 几 多 起 伏 ， 期 间 微软 
民 ，OpenGL 开 放 和 跨 平 台 的 优势 开始 凸显 ， 相 信 OpenGL 的 明天 会 更 加 美好 。 


展 阶段 。 对 于 Android 平 台 来 阅 ， 比 较 成 熟 的 游戏 引擎 有 Andengine、Cocos2d-x 以 及 Unity 3D 等 ， 在 13.2 节 中 ， 我 们 将 会 对 上 述 几 个 手 游 引擎 进行 详 


其 本 身 也 包含 了 一 个 强大 且 方 便 的 底层 图 形 库 。OpenGL 是 目前 行业 内 接纳 最 为 广泛 的 2D/3D 图 形 API， 被 广泛 运 


网 


形 标准 (DirectX) 的 快速 


负责 定义 和 推广 。OpenGL ES 是 从 


的 特性 。 经 过 多 年 发 
1.5 规 范 为 基础 ， 他 们 分 别 支持 common 和 common | 


要 有 两 个 版 本 。 首 先 ，OpenGL ES 
ite 两 种 profile，lite profile 只 支持 定点 


实数 ， 而 common profile 既 支持 定点 数 又 支持 浮 点 数 。 其 次 ，OpenGL ES 2.x 则 针对 可 编程 管线 硬件 ， 是 参照 OpenGL 2.0 规 范 定义 的 ，common profile 中 引入 了 对 可 编程 管线 的 支持 。 需 要 注意 的 是 ， 


Android SDK 中 提供 了 android.opengl 类 包 来 支持 OpenGL ES 的 
讲述 Android 系 统 中 OpenGL ES 的 基础 用 ; 


OpenGL 的 实例 项 目 app-demo-opengl 位 


示 。 


和 第 11 章 中 的 app-demo-special 项 目 类 似 ， 应 用 实例 的 3 
形 泻 染 这 里 就 不 介绍 了 ， 下 面 我 们 以 OpenGL 中 比较 常用 的 3D 图 形 泻 染 为 例 进行 讲解 ， 按 下 “Demo 3D” 按 钮 即 可 进入 该 实例 界面 ， 如 图 13-6 所 示 。 


D 


虽然 OpenGL 2.0 向 下 兼容 OpenGL 1.5， 但 是 OpenGL ES 2.0 却 不 兼容 OpenGL ES 1.x, 


为 这 是 两 种 完全 不 同 


在 一 些 3D 


虽然 新 版 的 Android SDK/NDK 已 经 支持 OpenGL ES 2.0， 但 是 考虑 到 兼容 大 部 分 设备 ， 在 实际 项 目 中 ， 我 人 
Android SDK 已 经 为 我 们 提供 了 方便 的 类 库 ， 所 以 OpenGL ES 通常 会 


发 ， 开 发 的 一 般 思 路 是 使 


源 代 码 目 录 中 的 opengl 


录 下 ， 我 们 可 以 使 


o 


的 实现 。 


] 仍 会 选择 使 


ipse 的 Import 工 具 把 该 项 


界面 上 排列 着 实例 选项 的 按钮 ， 这 里 包含 了 2D 


图 


形 泻 染 、3D 


OpenGL ES 1.0 和 OpenGL ES 1.1 版 本 进行 开发 。 另 外 ， 在 2D 图 形 方面 


形 泻 染 以 及 OpenGL 高 级 


OpenGL 的 视图 类 GLSurfaceView 和 泻 染 嚣 类 Renderer 来 实现 ， 下 面 我 们 将 通过 一 个 物件 泻 染 的 实例 来 


导入 进来 ， 然 后 就 可 以 直接 在 Android 模 拟 器 上 运行 了 ， 界 面 效果 如 图 13-5 所 


法 (包括 纹理 、 贴 图 、 光 照 ) 的 3 个 实例 。 至 于 2D 


CHENGL Demos ; 


DeniazD 


Demi 3D 


Dema 3D Testure 


13-5 ”OpenGL 实 例 项 目 主 菜单 


S LL re B:22 


图 13-6 ”3D 图 形 泻 染 实 例 


我 们 可 以 看 到 ， 该 界面 中 展示 的 是 一 个 不 断 旋转 的 彩色 立方 体 。 该 实例 的 完整 代码 都 在 项 目 源 码 目录 中 的 com.app.demos.opengl.demo 包 下 ， 其 中 包含 3 个 Java 源 码 文件 ， 即 DemoGL3djava、 


CubeRendererjava 以 及 Cubejava， 分 别 对 应 了 DemoGL3d、CubeRenderer 以 及 Cube 这 3 个 类 ， 下 面 我 们 逐个 进行 分 析 。 首 先 ，DemoGL3d 类 代码 如 清单 13-4 所 示 。 


代码 清单 13-4 


package com.app.demos.opengl .demo; 

import android.app.Activity; 

import android.opengl.GLSurfaceView; 

import android.opengl.GLSurfaceView.Renderer; 

import android.os.Bundle; 

public class DemoGL3d extends Activity { 
private GLSurfaceView glSurfaceView; 
private Renderer renderer; 


GOverride 


public void onCreate (Bundle savedInstanceState) 
super.onCreate (savedInstanceState); 


renderer - new CubeRenderer (true); 
glSurfaceView = new GLSurfaceView (this); 


glSurfaceView.setRenderer (renderer); 
setContentView (glSurfaceView) ; 


{ 


DemoGL3d 继 承 自 Activity 类 ， 是 该 3D 实 例 的 界 
就 是 CubeRenderer 对 象 。 实 际 上 ，DemoGL3d 类 只 是 个 入 [ 


代码 清单 13-5 


m 


package com.app.demos.opengl.demo; 
import javax.microedition.khronos.egl.EGLConfig; 
import javax.microedition.khronos.opengles.GL10; 
import android.opengl.GLSurfaceView.Renderer; 
public class CubeRenderer implements Renderer { 
private boolean mTranslucentBackground; 
private Cube mCube; 
private float mAngle; 
public CubeRenderer (boolean useTranslucentBackground) { 
mTranslucentBackground = useTranslucentBackground; 
mCube = new Cube(); 


} 


public void onDrawFrame(GL10 gl) { 
// 清除 屏幕 和 深度 缓存 
g1. glClear (GL10.GL COLOR BUFFER BIT | GL10.GL DEPTH BUFFER BIT); 
// REG HBA GLEE) 
gl.glMatrixMode (GL10.GL_MODELVIEW) ; 
// 重 置 当 前 观察 矩阵 
gl.glLoadIdentity (); 
// 设置 物体 坐标 
gl.glTranslatef(0, 0, -3.0f); 
// 设置 旋转 方式 
gl.glRotatef(mAngle, 0, 1, 0); 


gl.glRotatef (mAngle * 0.25f, 1, 0, 0); 


// 允许 设置 顶点 和 顾 色 
gl.glEnableClientState (GL10.GL_VERTEX_ARRAY) ; 
gl.glEnableClientState (GL10.GL COLOR ARRAY); 


// 绘制 立方 体 


mCube.draw (gl) ; 
// 如 果 要 绘制 另 一 个 立方 体 ， 可 以 打开 以 下 注释 试 试 


gl.glRotatef (mAngle * 2.0f, 0, 1, 1); 
gl.glTranslatef(0.5f, 0.5f, 0.5f); 


mCube.draw (gl); 


// RETE 


mAngle += 1.2f; 


) 


' 


public void onSurfaceChanged (GL10 gl, int width, int height) { 
gl.glViewport (0, 0, width, height); 
// 设置 投影 矩阵 


float ratio = (float) width / height; 


gl.glMatrixMode (GL10.GL PROJECTION); 
gl.glLoadIdentity (); 
gl.glFrustumf(-ratio, ratio, -1, 1, 1, 10); 


) 


public void onSurfaceCreated(GL10 gl, EGLConfig config) { 


// 全 局 配置 


gl.glDisable (GL10.GL_DITHER) ; 
gl.glHint (GL10.GL_PERSPECTIVE CORRECTION HINT, GL10.GL FASTEST); 
gl.glEnable(GL10.GL CULL FACE); 

gl.glShadeModel(GL10.GL SMOOTH); 
gl.glEnable(GL10.GL DEPTH TEST); 


// 设置 背景 


if (mTranslucentBackground) { 


gl.glClearColor(0, 0, 0, 0); 


} else { 


gl.glClearColor(1, 1, 1, 1); 


CubeRenderer 类 实现 了 泻 染 器 接 


进行 分 析 。 


1.onDrawFrame 方 法 


OpenGL 封 装 的 画面 重 绘 方法 ， 功 能 和 前 面 GameSurfaceViewDemo 中 
glMatrixMode、glLoadldentity 以 及 glRotatef 等 。 实 际 上 ， 这 些 方 法 的 作 | 


Renderer 类 中 的 几 个 3 


要 方法 ， 程 序 3 


法 来 实现 的 ，Cube 类 的 实现 可 参考 代码 清单 13-6。 


2.onSurfaceChanged 人 方法 


该 方法 中 的 逻辑 会 在 视 医 


网 


者 可 以 自行 了 解 ， 这 些 概念 对 3D| 


像 变 化 的 时 候 被 调用 ， 其 实 就 是 对 图 像 进行 了 投影 变 
图形 开发 还 是 非常 有 用 的 。 


3.onSurfaceCreated 方 法 


该 方法 中 包含 了 一 些 与 视 | 


网 


=l 


控制 器 类 。 该 类 的 代码 比较 简单 ， 主 要 逻辑 都 在 onCreate 方 法 中 ， 这 里 主要 关注 GLSurfaceView 类 的 使 
的 泻 染 逻 辑 都 在 CubeRenderer 类 中 ， 


体 实 现 见 代 码 清单 13-5。 


方法 ， 以 及 如 何 设置 该 视图 类 的 泻 染 器 ， 也 


要 都 是 通过 GL10 对 象 ， 也 就 是 OpenGL 1.0 对 应 的 类 对 象 ， 来 渲染 屏幕 和 物件 的 。 接 下 来 ， 我 们 将 对 该 类 中 主要 方法 的 逻辑 


的 doDraw 方 法 类 似 。 该 方法 配制 了 画面 中 每 一 帧 的 视图 显示 ， 这 里 我 们 可 以 看 到 GL10 对 象 党 
在 代码 注释 中 已 经 写 得 很 清楚 了 。 另 外 ， 我 们 注意 到 ， 立 方 体 的 绘制 的 逻辑 并 不 在 这 里 ， 而 是 通过 调用 Cube 类 对 象 的 draw 方 


， 进 而 得 到 了 真正 的 3D 


初始 化 有 关 的 逻辑 ， 这 里 我 们 还 可 以 学 习 到 另外 一 些 GL10 对 象 的 常 


前 面 分 析 CubeRenderer 类 代码 时 ， 我 们 曾经 提 到 过 ， 立 方 体 的 泻 染 逻辑 都 在 Cube 类 中 。 


出 其 他 形形色色 的 物件 对 象 。Cube 类 的 完整 实现 如 代码 清单 13-6 所 示 。 


dipl 


D 


方法 。 当 然 ， 这 些 方法 是 与 OpenGL 全 


方法 的 使 用 ， 如 glClear、 


像 。 限 于 篇 幅 ， 这 里 就 不 介绍 与 3D 视 角 变 换 有 关 的 矩阵 算法 方 | 


的 基础 知识 了 ， 有 兴趣 的 读 


局 配制 有 关 的 。 此 外 ， 该 方法 还 包含 了 视图 背景 配制 的 逻辑 。 


实 上 ， 这 种 封装 方法 常用 在 实际 项 目 中 ， 比 较 符合 面向 对 象 编程 (OOP) 的 思路 ， 类 似 地 ， 我 们 还 可 以 封装 


代码 清单 13-6 


package com.app.demos.opengl.demo; 
import java.nio.ByteBuffer; 
import java.nio.ByteOrder; 
import java.nio.IntBuffer; 
class Cube { 
private IntBuffer mVertexBuffer; 
private IntBuffer mColorBuffer; 
private ByteBuffer mIndexBuffer; 
public Cube() { 
int one = 0x10000; 
// 顶点 数组 
int vertices[] = { 
-one, -one, -one, 
one, -one, -one, 
one, one, -one, 
-one, one, -one, 
-one, -one, one, 
one, -one, one, 
one, one, one, 
-one, one, one 
Ë 
// 颜色 数组 
int colors[] = [í 
0, 0, 0, one, 
one, 0, 0, one, 
one, one, 0, one, 
0, one, 0, one, 
0, 0, one, one, 
one, 0, one, one, 
one, one, one, one, 
0, one, one, one 


F 
// 索引 数组 


byte indices 


[ 
0, 4, 5, 0, 5, 1, 
1, 5, 6, 1, 6, 2, 
2, 6, 7, 2, 7, 3, 
3, 7, 4, 3, 4, 0, 
4, 7, 6, 4, 6, 5, 
3, 0, 1 3,1, 2 


1 O, 


E 
// 顶点 ByteBuffer 


ByteBuffer vbb = ByteBuffer.allocateDirect (vertices.length * 4); 


vbb.order (ByteOrder.nativeOrder()); 
mVertexBuffer = vbb.asIntBuffer(); 
mVertexBuffer.put (vertices) ; 
mVertexBuffer.position (0); 

// 颜色 ByteBuffer 


ByteBuffer cbb = ByteBuffer.allocateDirect (colors.length * 4); 


cbb.order (ByteOrder.nativeOrder () ) ; 
mColorBuffer = cbb.asIntBuffer(); 
mColorBuffer.put (colors) ; 
mColorBuffer.position (0) ; 
// 索引 ByteBuffer 
mIndexBuffer = ByteBuffer.allocateDirect 
mIndexBuffer.put (indices); 
mIndexBuffer.position (0) ; 

} 

public void draw (GL10 gl) { 
gl.glFrontFace (GL10.GL_CW) ; 
gl.glVertexPointer (3, GL10.GL_FIXED, 0, 


(indices.length); 


mVertexBuffer) ; 


gl.glColorPointer (4, GL10.GL_FIXED, 0, mColorBuffer) ; 
gl.glDrawElements (GL10.GL_TRIANGLES, 36, GL10.GL UNSIGNED BYTE, mIndexBuffer) ; 


法 使 用 。 初 始 化 完毕 之 后 ， 接 着 就 是 在 draw 方 法 中 进行 绘图 了 ， 这 里 需要 特别 注意 glDrawElements 方 法 的 用 法 。 


glDrawElements 方 法 的 4 个 参数 分 别 是 : 绘制 类 型 、 顶 点 数 、 参 数 类 型 以 及 索引 数据 。 以 这 里 的 立方 体 为 例 ， 绘 制 类 型 使 


装 ; 顶点 数 则 可 按照 “三 角形 面 数 *3” 的 公式 得 到 ; 最 后 的 索引 


glDrawArray 方 法 的 具体 用 法 ， 这 里 不 再 歼 述 。 


至 此 , 我们 学 习 了 在 Android 系 统 中 使 用 OpenGL 进 行 2D 和 3D 


除了 glDrawElements 方 法 之 外 ，OpenGL 中 还 经 常 使 用 glDrawArray 方 法 来 进行 绘 | 


| 数 则 是 用 于 构造 立方 体 表面 的 12 个 三 角形 ， 索 引 


D 


四 | 


(Light) 、 透 明 (Alpha) 以 及 混 色 (Color Mixing) $, hJ 
效果 如 图 13-7 所 示 。 


， 此 方法 常 被 用 于 2D 


D 


形 绘制 中 ， 


Cube 类 中 只 有 两 个 方法 ， 即 构造 方法 Cube 和 绘图 方法 draw。 首 先 ， 在 构造 方法 中 ， 程 序 对 立方 体 项 点 、 颜 色 、 索 引进 行 了 设置 ， 并 将 这 些 数组 转换 成 IntBuffer 和 ByteBuffer 对 象 ， 供 GL10 对 象 的 方 


的 是 三 角形 ， 即 GL TRIANGLES, 一般 来 说 3D 模 型 都 会 使 用 三 角形 进行 拼 
数 其 实 就 是 顶点 数组 中 8 个 顶点 的 索引 位 置 ， 值 从 0 到 7 不 等 。 


用 法 相对 比较 简单 ， 大 家 可 以 在 “Demo 2D” 实 例 的 源 代 码 中 看 到 


篇 幅 所 限 ， 这 里 就 不 做 更 多 介绍 了 ， 


感 兴趣 的 读者 可 以 按 下 应 


ERI 


H 


形 绘制 的 基本 方法 与 思路 。 实 际 上 ， 在 3D 图 形 完成 绘制 之 后 ， 还 会 有 其 他 的 常规 泻 染 步骤 ， 如 纹理 映射 (Texture). 56 


BER 


中 的 “Demo 3D Texture” 按 钮 ， 进 入 OpenGL 高 级 有 


法 实例 ， 显 示 


图 13-7 3DD 图 形 贴图 效果 


我 们 可 以 看 到 以 上 实例 采用 了 皮毛 材质 的 外 观 图 片 ， 并 综合 使 用 了 纹理 、 贴 图 、 光 照 以 及 混 色 等 比较 高 级 的 泻 染 技术 ， 展 示 出 了 一 个 比较 真实 的 3D 物 件 。 由 于 篇 幅 所 限 ， 就 不 对 以 上 实例 的 代码 做 更 多 
分 析 了 ， 感 兴趣 的 读者 可 以 自行 分 析 该 实例 的 源码 ， 并 顺 着 其 中 的 开发 思路 继续 往 下 探索 。 


13.1.5 ”使 用 RenderScript 


Android 在 绘图 方面 的 性 能 表现 直至 引入 NDK 之 后 才 有 所 改善 。 然 而 ， 在 新 版 本 的 Android 系 统 (Honeycomb) 中 发 布 了 RenderScript 这 一 “杀手 级 ”功能 模块 后 ， 大 大 加 强 了 Android 本 地 语言 的 执 
行 能 力 和 计算 能 


Renderscript 是 一 种 低级 的 高 性 能 编程 语言 ， 常 用 于 3D 演 染 和 密集 型 计算 。RenderScript 采 用 了 c99 语 法 标准 ， 脚 本 代码 比较 精简 ; 并且 具 备 了 类 似 于 CUDA 的 并 行 计算 API 用 于 计算 ,运行 速度 方面 其 
至 超过 了 NDK 的 实现 方式 。 但 是 ， 考 虑 到 其 性 能 方面 的 优势 ， 还 是 推荐 大 家 进行 学 习 。 


Renderscript 脚 本 的 后 缀 名 为 “.rs”， 以 下 我 们 简称 为 rs 脚本 ， 其 运行 原理 和 Android NDK 差 不 多 。 在 运行 的 时 候 ，Android 编 译 工具 会 生成 对 应 的 Java 类 ， 将 rs 脚本 转化 成 bc 二 进 制 码 ， 然 后 我 们 在 
程序 的 演 染 逻辑 中 就 可 以 直接 使 用 。 下 面 是 一 个 RenderScript 的 使 用 范例 helloworld.rs， 如 代码 清单 13-7 所 示 。 


代码 清单 13-7 


#pragma version (1) 
#pragma rs java package name (com.my.package.name) 
#include "rs graphics.rsh" 
int gTouchX; 
int gTouchY; 
void init()( 
// 设置 默认 坐标 
gTouchX = 50.0f; 
gTouchY = 50.0f; 
] 
int root(int launchID) ( 
// 设置 背景 颜色 
rsgClearColor(0.0f, 0.0f, 0.0f, 0.0£); 
// 设置 字体 颜色 
rsgFontColor(1.0f, 1.0f, 1.0f, 1.0f); 
// 显示 文字 信息 
rsgDrawText ("Hello World!", gTouchX, gTouchY); 
// 重 绘 间隔 时 间 〈 单 位 毫秒 ) 


return 100; 


从 代码 清单 13-7 中 我 们 可 以 看 出 Renderscript 中 最 重要 的 两 个 方法 是 init 和 root， 分 别 对 应 着 初始 化 和 重 绘 的 逻辑 。 接 着 ，Android 开 发 工具 会 生成 对 应 的 脚本 映射 类 ScriptC_helloworld， 而 编译 工 
则 会 生成 对 应 的 二 进 制 码 helloworld.bc。 然 后 ， 我 们 就 可 以 创建 一 个 脚本 辅助 类 HelloWorldRS， 以 便 在 程序 中 调用 RenderScript 脚 本 。HelloWorldRS 类 的 示例 代码 如 代码 清单 13-8 所 示 。 


代码 清单 13-8 


public class HelloWorldRS { 

private RenderScriptGL mRS; 

private ScriptC_hellowold mScript; 

public HelloWorldRS (RenderScriptGL rs, Resources resource) { 
// 绑 定 脚本 
mRS = rs; 
mScript = new ScriptC_helloworld(mRS, resource, R.raw.hellowold); 
mRS.bindRootScript (mScript) ; 

$ 

public void onActionDown(int x,int y) { 
// 设置 坐标 
mScript.set gTouchX (x); 
mScript.set gTouchY (y); 


) 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


在 HelloWorldRs 类 中 ， 我 们 主要 关注 脚本 映射 类 ScriptC_helloworld 的 创建 ， 以 及 脚本 绑 定 方法 bindRootscript 的 使 用 。 最 后 ， 我 们 就 可 以 在 界面 视图 类 HelloWorldView 中 使 用 该 脚本 辅助 类 
HelloWorldRS 了 。HelloWorldView 类 的 示例 代码 如 代码 清单 13-9 所 示 。 


代码 清单 13-9 


public class HelloWorldView extends RSSurfaceView ( 
private RenderScriptGL mRS; 
private HelloWorldRS mRender; 
public HelloWorldView (Context context) { 
super (context) ; 
initRenderScript (); 
š 
private void initRenderScript() { 
if (mRS == null) { 
// 使 用 默认 的 脚本 配置 
RenderScriptGL.SurfaceConfig config = new SurfaceConfig(); 
mRS = createRenderScriptGL(config); 
// 初始 化 脚本 辅助 类 HelloWorldRS 
mRender = new HelloWorldRS (mRS, getResources()); 
} 
} 
GOverride 
public boolean onTouchEvent (MotionEvent event) ( 
// 获取 坐标 位 置 
if (event.getAction() == MotionEvent.ACTION DOWN) { 
mRender.onActionDown((int) event.getX(), (int) event.getY()); 
return true; 
} 


return false; 


} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


至 此 ,我 们 已 经 学 习 了 RenderScript 脚 本 的 基础 概念 和 基本 用 法 。 限 于 篇 幅 ， 这 里 不 做 进一步 讨论 。 更 多 与 RenderScript 使 用 有 关 的 信息 可 以 参考 Android SDK 开 发 向 导 文档 (Dev Guide) 
中 “Graphics” 菜单 下 的 “3D with Renderscript” 部 分 的 内 容 。 


13.2 ” 手 游 开 发 进 阶 


前 面 我 们 介绍 了 与 Android 手 游 开 发 相关 的 基础 概念 ， 接 下 来 又 到 了 “学 以 致 用 ”的 时 候 了 。 虽 然 我 们 已 经 学 习 了 Android 手 游 开发 的 基本 思路 以 及 OpenGL 类 库 的 基础 用 法 ， 也 完全 有 可 能 按照 游戏 引 
警 的 设计 思路 ， 实 现 出 自己 的 Android 手 游 引 擎 。 但 是 ， 在 实际 项 目 中 往往 不 允许 我 们 这 么 做 ， 我 们 还 要 考虑 到 采用 引擎 的 稳定 性 、 兼 容 性 以 及 运行 是 否 高 效 的 问题 。 所 以 ， 我 们 会 采用 一 些 相对 比较 成 熟 


的 引 丈 框架 ， 目 前 手 游 界 使 用 最 为 广泛 的 2D 和 3D 游 戏 引擎 分 别 是 Cocos2d-x 和 Unity 3D。 


13.2.1 认识 Cocos2d-x 


Cocos2d-x 是 一 个 开源 的 2D 手 游 引 擎 ， 从 Cocos2d-iPhone 项 目 发 展 而 来 。 如 今 Cocos2d-x 引 警 已 经 发 展 成 为 一 个 强大 的 跨 平台 的 游戏 开发 框架 ， 支 持 IOS、Android、Windows、Linux 等 诸多 主流 操 
作 系 统 ， 甚 至 还 包括 HTML 5 的 版 本 。Cocos2d-x 的 所 有 源码 都 使 用 MIT License， 目 前 有 以 下 几 个 分 支 (Branch) 版 本 。 


: Native branch: 引擎 源码 的 主 分 支 ， 使 用 C++、jJava、Obijective-C 来 编写 ， 也 包含 部 分 的 Lua 和 JavaScript 脚 本 代码 。 
: HTML 5 branch: HTML 5 版 本 的 源码 ， 即 Cocos2d-html5 项 目的 源码 ， 主 要 使 用 JavaSctipt 来 实现 。 
: XNA Port: 使 用 C# 实 现 的 版 本 ， 用 于 Windows Phone 和 XNA 设 备 上 。 


使 用 Cocos2d-x 来 进行 2D 游 戏 开发 是 非常 方便 的 ， 在 游戏 程序 开发 完成 后 ， 还 可 以 很 方便 地 封装 成 各 个 操作 系统 的 版 本 。 更 多 相关 信息 和 资源 请 访问 Cocos2d-x 项 目 官网 ， 地 址 
是 http://www.cocos2d-x.org/。 


13.22 ”架设 Cocos2d-x 开 发 环境 


Cocos2d-x 的 开发 环境 和 Android NDK 差 不 多 ， 开 发 工具 使 用 Eclipse+ADT+CDT 的 组 合 ; 此 外 ，Android SDK 和 NDK 也 是 必 不 可 少 的 ， 大 家 可 以 参考 12.2.1 节 的 内 容 。 除 了 以 上 的 开发 组 件 之 外 ， 当 
然 还 有 最 重要 的 Cocos2d-x 的 SDK 开 发 包 。 我 们 可 以 从 Cocos2d-x 官 方 Wiki 站 点 上 下 载 ， 地 址 是 : http://www.cocos2d-x.org/projects/cocos2d-x/wiki/Download, 


Cocos2d-x 的 SDK 目 前 有 两 大 版 本 ， 即 1.0 和 2.0， 分 别 对 应 于 OpenGL ES 的 1.1 和 2.0 版 本 。 这 里 我 们 选择 使 用 1.0 版 本 中 的 最 新 开发 包 (cocos2d-1.0.1-x-0.13.0-beta) ， 原 因 有 两 个 ， 其 一 ，1.0 版 能 
更 好 地 兼容 普通 设备 ; 其 二 ，Android 模 拟 器 不 支持 OpenGL ES 2.0。 下 载 之 后 ， 解 压 安装 到 对 应 目录 下 即 可 ， 建 议 同 Android SDK 以 及 NDK 安 装 在 同一 目录 下 ， 比 如 D: \cocos2d。 


Cocos2d-x 的 SDK 中 包含 了 丰富 的 类 库 代 码 和 开发 工具 ， 但 是 为 了 更 好 地 兼容 Windows 下 使 用 Eclipse 开发 的 方式 ， 我 们 还 需要 在 SDK 根 目录 下 添加 编译 脚本 cocos2d-build.bat， 该 脚本 非常 重要 ， 如 
代码 清单 13-10 所 示 ， 此 脚本 的 功能 和 NDK 中 的 ndk-build.cmd 类 似 。 


代码 清单 13-10 


@echo off 

rem This script must be under cocos2d root 

set NDK ROOT=D:Nandroid-ndk-r7 

set NDK_MODULE_PATH=%~dp0; %~dp0/cocos2dx/platform/third_party/android/prebuilt 
$NDK ROOT$/ndk-build.cmd %* 


13.23 gi Cocos2d-JABH 


Cocos2d-x 的 开发 包 (SDK) 中 已 经 包含 了 一 个 最 基础 的 游戏 项 目 实例 HelloWorld， 下 面 我 们 就 将 以 此 为 例 ， 给 大 家 介绍 Cocos2d-x 游 戏 开发 的 基本 步骤 。 首 先 ， 还 是 使 用 Eclipse 的 项 目 创建 向 导 创 建 
一 个 新 的 “Android Project" ; 然后 ， 在 Android 项 目 创建 界面 中 选择 “Create Project from existing source” 选 项 ， 再 从 本 地 目录 选择 界面 中 找到 Cocos2d SDK 目 录 (D: \cocos2d) ， 并 依次 选 
择 “HelloWorld” 一 “android”， 如 图 13-8 所 示 。 
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Eclipse 将 会 自动 为 我 们 创建 一 个 名 为 ApplicationDemo 的 项 目 (也 就 是 前 面 


小 贴 士 : 以 下 的 “ApplicationDemo 项 目 ” 同 “HelloWorld” 项 目 。 


图 13-8 ”选择 Cocosd-x 源 码 中 的 HelloWorld 项 目 


的 HelloWorld 项 目 ， 只 是 定义 的 项 目 名 不 同 ) 。 另 外 ，SDK 版 本 也 会 被 自动 选择 到 Android 2.1 的 版 本 ， 如 


图 13-9 所 示 。 
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13-9 创建 HelloWorld (ApplicationDemo) 项 目 


打开 Package Explorer 中 的 ApplicationDemo 项 目 代码 树 ， 我 们 可 以 看 到 该 Cocos2d-x 项 目的 基本 目录 结构 和 重要 代码 文件 ， 如 图 13-10 所 示 。 
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图 13-10 ApplicationDemo (HelloWorld) 项 目 代码 树 


该 项 目的 目录 结构 和 普通 的 NDK 项 目 并 没有 太 大 的 不 同 ， 我 们 重点 关注 下 面 几 个 文件 。 首 先是 src 目 录 下 org.cocos2dx.application 包 中 的 ApplicationDemojava 文 件 ， 根 据 项 目 配置 文件 
AndroidManifest.xml 中 的 设置 ，ApplicationDemo 类 是 整个 游戏 的 入 口 ， 该 类 的 逻辑 实现 可 参考 代码 清单 13-11。 


代码 清单 13-11 


package org.cocos2dx.application; 
import org.cocos2dx.lib.Cocos2dxActivity; 
import org.cocos2dx.lib.Cocos2dxEditText; 
import org.cocos2dx.lib.Cocos2dxGLSurfaceView; 
import android.os.Bundle; 
public class ApplicationDemo extends Cocos2dxActivity( 
private Cocos2dxGLSurfaceView mGLView; 
protected void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
// 获取 包 名 ， 用 户 设置 资源 路 径 
String packageName = getApplication() .getPackageName () ; 
super. setPackageName (packageName) ; 
setContentView (R. layout .helloworld_demo) ; 
mGLView = (Cocos2dxGLSurfaceView) findViewById(R.id.helloworld gl surfaceview); 
mGLView.setTextField((Cocos2dxEditText) findViewById (R.id.textField)); 
} 
@Override 
protected void onPause() { 
super .onPause () ; 
mGLView.onPause () ; 
} 
@Override 
protected void onResume() { 
super.onResume () ; 
mGLView.onResume () ; 
} 
static { 
System. loadLibrary ("helloworld") ; 
} 


ApplicationDemo 类 代码 中 其 实 并 没有 太 复 杂 的 逻辑 ， 其 中 最 主要 的 有 两 点 : 其 一 ， 初 始 化 了 Cocos2dxGLSurfaceView 控 件 对 象 ， 这 个 自 定义 的 View 控 件 继承 自 Android 的 OpenGL 基 础 类 
GLSurfaceView， 具 体 实现 可 参考 org.cocos2dx.lib 包 中 的 Cocos2dxGLSurfaceView.java 文 件 ; 其 二 ， 载 入 了 helloworld 动 态 链 接 库 ， 此 库 是 通过 NDK 工 具 将 本 地 的 C 和 C++ 代码 编译 而 成 的 。 紧 接着 就 让 
我 们 来 看 看 jni 目 录 下 的 Android.mk 文 件 ， 该 文件 负责 保存 项 目 代 码 的 编译 配置 ， 其 中 定义 了 本 项 目 需要 包含 的 类 库 、 需 要 编译 的 C 和 C++ 源码 以 及 最 终 的 so 文件 等 ， 如 代码 清单 13-12 所 示 。 


代码 清单 13-12 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 
LOCAL MODULE := helloworld shared 
LOCAL MODULE FILENAME := libhelloworld 
LOCAL SRC FILES := helloworld/main.cpp \ 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/../http: //www.hzcourse.com/resource/readBook?path-/or 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/ . . /http: / /ww.hzcourse.com/resource/readBook?path-/or 
LOCAL C INCLUDES := $(LOCAL PATH) /http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15327/OEBPS/Text/ . . /http: / /www.hzcourse.com/resource/re 
LOCAL WHOLE STATIC LIBRARIES := cocos2dx static E 
include $(BUILD SHARED LIBRARY) 
$(call import-module, cocos2dx) 


从 Android.mk 文 件 中 我 们 可 以 注意 到 本 地 的 C+ + 源码 文件 除了 helloworld/main.cpp 之 外 ， 还 包括 上 两 层 目录 ( 即 项 目 目录 HelloWorld) 之 下 的 Classes 目 录 中 的 AppDelegate.cpp 和 
HelloWorldScene.cpp 文 件 。 接 下 来 ， 我 们 先 来 分 析 一 下 main.cpp 的 代码 逻辑 ， 如 代码 清单 13-13 所 示 。 


代码 清单 13-13 


#include "AppDelegate.h" 

#include "cocos2d.h" 

#include "platform/android/jni/JniHelper.h" 

#include <jni.h> 

#include <android/log.h> 

#define LOG_TAG "main" 

#define IOGD(http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/...) android log print(ANDROID LOG DEBUG, LOG TAG, VA A 
using namespace cocos2d; T ud EE Tr T m 
extern "C" 


jint JNI OnLoad(JavaVM *vm, void *reserved) 
{ 
JniHelper::setJavaVM (vm); 
return JNI VERSION 1 4; 
l 
void Java org cocos2dx lib Cocos2dxRenderer nativeInit(JNIEnv* env, jobject thiz, jint w, jint h) 
{ 
if (!cocos2d: :CCDirector: :sharedDirector () ->getOpenGLView () ) 
{ 
cocos2d::CCEGLView *view = &cocos2d: :CCEGLView: : sharedOpenGLView () ; 
view-»setFrameWidthAndHeight (w, h); 
// 如 果 要 在 WVGA 中 使 用 HVGA 的 ， 可 以 打开 以 下 注释 
cocos2d: :CCDirector: :sharedDirector () ->setOpenGLView (view) ; 


AppDelegate *pAppDelegate = new AppDelegate () 7 
cocos2d: :CCApplication::sharedApplication().run(); 


cocos2d: :CCTextureCache: :reloadAllTextures () ; 
cocos2d: :CCDirector: :sharedDirector () ->setGLDefaultValues () ; 


main.cpp 文 件 中 包含 了 整个 游戏 逻辑 的 入 口 程序 ， 主 要 实现 了 org.cocos2dx.lib 库 下 的 Cocos2dxRenderer 类 的 nativelnit 方 法 ， 也 就 是 对 游戏 主场 景 初始 化 逻辑 的 实现 ， 此 方法 的 逻辑 并 不 复杂 ， 先 使 
getOpenGLView 方 法 判断 场景 是 否 已 经 演 染 过 了 ， 否 则 就 使 用 setOpenGLView 方 法 设置 CCEGLView， 并 执行 CCApplication 的 run 方 法 来 运行 游戏 。 


另外 ，AppDelegate.cpp 和 HelloWorldscene.cpp 这 两 个 C++ 程序 文件 是 对 游戏 主要 逻辑 的 实现 。 其 中 AppDelegate.cpp 中 包含 的 是 全 局 的 游戏 初始 化 逻辑 ， 而 HelloWorldscene.cpp 中 则 是 对 游戏 
项 目 主场 景 的 实现 。 在 ppDelegate.cpp 文 件 中 要 注意 applicationDidFinishLaunching 方 法 的 逻辑 ， 也 就 是 游戏 的 启动 逻辑 ， 如 代码 清单 13-14 所 示 。 


代码 清单 13-14 


http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
bool AppDelegate: :applicationDidFinishLaunching () 
{ 


// 初始 化 CCDirector 对 象 
CCDirector *pDirector = CCDirector::sharedDirector(); 
pDirector-»setOpenGLView (&CCEGLView: :sharedOpenGLView () ) ; 
// 打开 FPS 显 示 
pDirector->setDisplayFPS (true) ; 
// 设置 FPS， 默 认 值 为 1 .0/60 
pDirector->setAnimationInterval (1.0 / 60); 
// 创建 场景 (Scene) ， 该 对 象 是 自动 释放 (autorelease) 的 
CCScene *pScene = HelloWorld::scene(); 
// 运行 场景 
pDirector-»runWithScene (pScene) ; 
return true; 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


启动 逻辑 中 先 对 游戏 进行 了 常见 的 全 局 设置 ， 然 后 使 用 HelloWorld 类 中 的 scene 方 法 获取 场景 并 运行 该 场景 ，HelloWorld 类 对 应 的 程序 文件 就 是 HelloWorldScene.cpp， 接 下 来 我 们 就 来 介绍 一 下 该 程 
序 文件 的 代码 逻辑 ， 如 代码 清单 13-15 所 示 。 


代码 清单 13-15 


#include "HelloWorldScene.h" 
USING NS CC; 
CCScene* HelloWorld: :scene () 
{ 
// 场景 对 象 ( 自 动 释放 ) 
CCScene *scene = CCScene::node(); 
// 场景 层 对 象 (自动 释放 ) 
HelloWorld *layer = HelloWorld: :node (); 
// 在 场景 中 添加 层 
scene->addChild (layer); 
// 返回 场景 对 象 
return scene; 


l 
// 游戏 初始 化 方法 
bool HelloWorld::init() 


{ 
////////////////////////////// 
// 1. 调用 超 类 的 jnit 方 法 
if ( !CCLayer::init() ) 
{ 


return false; 


l 

///////////////////////////// 

// 2. 退出 按钮 逻辑 

// 添加 “close” 退 出 按钮 (自动 释放 ) 

CCMenuItemImage *pCloseItem = CCMenuItemImage::itemFromNormallmage ( 
"CloseNormal.png", 
"CloseSelected.png", 
this, 

menu_selector (HelloWorld: :menuCloseCallback) ); 

pCloseltem-»setPosition( ccp(CCDirector: :sharedDirector ()->getWinSize().width - 20, 20) ); 

// 创建 菜单 (自动 释放 ) 

CCMenu* pMenu = CCMenu: :menuWithItems (pCloseItem, NULL); 

pMenu->setPosition( CCPointZero ); 

this-»addChild(pMenu, 1); 

///////////////////////////// 

// 3. 53 逻辑 

// 创建 文字 "Hello World" 

CCLabelTTF* pLabel = CCLabelTTF::labelWithString("Hello World", "Arial", 24); 

// 获取 窗口 大 小 

CCSize size = CCDirector::sharedDirector()->getWinSize(); 

// 把 文字 居中 

pLabel->setPosition( ccp(size.width / 2, size.height - 50) ) 

// 在 层 上 显示 文字 

this->addChild(pLabel, 1); 

// 创建 元 素 (用 图 片 HelloWorld.png) 

CCSprite* pSprite = CCSprite::spriteWithFile ("HelloWorld.png") ; 

// 把 元 素 居中 

pSprite->setPosition( ccp(size.width/2, size.height/2) ); 

// 在 层 上 显示 元 素 

this->addChild(pSprite, 0); 

return true; 


} 
void HelloWorld: :menuCloseCallback (CCObject* pSender) 


CCDirector: :sharedDirector ()-»end(); 
#if (CC TARGET PLATFORM == CC PLATFORM IOS) 
exit(0); = m 
#endif 
} 


HelloWorld 类 中 包含 了 三 个 方法 。scene 方 法 用 于 返回 CCScene 对 象 ，init 方 法 中 包含 了 泻 染 场 景 的 主要 逻辑 ， 而 menuCloseCallback 则 是 退出 按钮 的 逻辑 实现 。 阅 读 代码 时 应 该 重点 关注 init 方 法 的 逻 
辑 ， 其 中 包含 了 退出 按钮 的 设置 、 背 景 图 的 设置 以 及 “Hello World” 字 符 串 的 打印 ， 建 议 大 家 结合 Cocos2d-x 的 API 文 档 进行 学 习 ， 由 于 篇 幅 原因 这 里 不 做 深入 介绍 。 


接 下 来 ， 我 们 来 尝试 编译 并 运行 该 HelloWorld 游 戏 项 目 ， 和 NDK 项 目 类 似 (可 参考 12.2.2 节 ) 的 ， 右 键 单 击 HelloWorld 项 目 ， 在 打开 的 下 拉 菜 单 中 选择 项 目的 属性 (Properties) 选项 ， 打 开 项 目 配置 
窗口 。 然 后 选中 左边 配置 列表 中 的 Builders 选 项 ， 并 单 击 右边 的 “New” 按钮 来 为 ApplicationDemo 项 目 创建 NDK 编 译 器 (Builder) ， 如 图 13-11 所 示 。 
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图 13-11 创建 NDK 编 译 器 


这 里 需要 选择 编译 器 (Builder) 类 型 ， 我 们 选择 Program 即 可 ， 如 图 13-12 所 示 。 


接着 进入 Builder 的 详细 配置 界面 ，Name 处 填写 ApplicationDemo_Builder，Location 参 数 填 入 Cocos2d 目 录 下 的 cocos2d-build.dat 工 具 的 路 径 (该 批 处 理 文件 用 


13.2.2 节 ) ，Working Directory 中 填写 游戏 项 目的 路 径 (可 使 用 “Browser Workspace” 按钮 进行 选择 ) ， 如 图 13-13 所 示 。 


于 编译 项 目 程序 ， 相 关内 容 可 参考 


Choose an external tool type to craata: 


[| | 


4 Ant Builder 
PHP Tools 


Program 


图 13-12 选择 编译 器 类 型 


© Edit Configuration 


Edit launch configuration properties 


Create a configuration that will run a program during builds 


Hame: ApplicationDemo_Builder 
[Main . ñ Refresh PW Environment | (7 Build Options 


Location: 
D: \cocos2d\cocos2d-build. bat 


Bronse File System 


-Forking Directory: 


$ {workspace_loc :/ApplicationDemo} 
— 


— Arguments: 


Note; Enclose an argument containing spaces using double-quotes (7). 


图 13-13 ”编译 器 主要 配置 界面 


然后 ， 选 中 “Build Options” 标 签 , 把 “Run the builder" 下面 的 选项 都 勾 选 上 ， 如 图 13-14 所 示 。 接 着 选中 “Specify working set of relevant resources” 选项， 并 点 击 右边 的 “Specify 
Resources” 按 钮 打开 窗口 “Edit Working Set" (资源 选择 ) ， 如 图 13-15 所 示 。 


我 们 在 “Edit Working Set” 窗 口中 选中 ApplicationDemo 项 目下 的 jni 目 录 ， 让 编译 器 知道 需要 编译 的 文件 所 在 的 目录 ， 如 图 13-15 所 示 。 


为 了 方便 开发 ， 我 们 还 可 以 在 Refresh 标 签 中 设置 需要 动态 编译 的 代码 文件 ， 如 图 13-16 所 示 。 此 时 Specify Resources 中 选择 窗口 的 设置 和 前 面 一 样 ， 见 图 13-15。 
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图 13-14 ”编译 器 选项 配置 界面 


E Edit Working Set 


Resource Working Set 


Enter a working set mame and select the working set resources. 
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图 13-15 选择 需要 编译 的 文件 
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图 13-16 选择 需要 动态 编译 的 文件 


全 部 配置 完毕 之 后 ， 我 们 会 在 原先 的 Builders 界 面 中 看 到 创建 完毕 的 HellojJni_Builder 编 译 器 ， 接 着 单 击 “OK” 按 钮 关闭 项 目 配置 窗口 。 一 般 来 说 ， 此 时 Eclipse 就 会 自动 开始 编译 项 目 了 。 但 是 ， 如 果 
没有 意外 我 们 会 遇 到 报错 “make: ***[obj/local/armeabi/libgnustl static.a]Error 1”， 这 个 错误 是 由 于 NDK r7 版 本 导致 的 ， 据 官方 信息 所 说 此 问题 会 在 下 一 个 版 本 中 修复 。 接 下 来 ， 我 们 需要 把 NDK 目 
3& (D: \android-ndk-r7) 下 面 的 sources/cxx-stl/gnu-libstdc++/libs/armeabi/ 目 录 之 下 的 libgnustl_static.a 库 文件 复制 到 HelloWorld 项 目的 编译 目录 obj/local/armeabi/ 中 去 ， 如 图 13-17 所 示 。 
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E 共享 此 文件 来 


图 13-17 手动 复制 libgnustl_static.a 库 文件 


使 用 Project 菜 单 下 的 Clean 选 项 清除 缓存 并 重新 编译 项 目 ， 这 次 才能 成 功 。 编 译 完成 需要 一 定时 间 ， 请 大 家 耐心 等 待 。 图 13-18 就 是 编译 完成 后 打印 出 的 结果 信息 ， 我 们 看 到 编译 完成 的 
libhelloworld.so 文 件 被 保存 到 libs/armeabi/ 目 录 下 。 


EEC ApplicationDemo_ Builder [Program] D:\cocos2d\cocos2d-build. bat 
Install libhelloworld.so => libs/armeabi/libhelloworld.so 


图 13-18 ” 库 文 件 编译 完成 信息 


另外 ， 由 于 编译 器 不 会 自动 安装 资源 文件 ， 所 以 我 们 需要 手动 把 D: \cocos2d\tests\Resources 目 录 下 的 文件 复制 到 ApplicationDemo 项 目的 assets 


录 中 ， 如 图 13-19 所 示 。 


最 后 ， 使 用 “Run As" 中 的 “Android Application” 安 装 ApplicationDemo 项 目 ， 即 将 HelloWorld 项 目 
“Ctrl+F11” 组 合 键 把 Android 模 拟 器 切换 到 横 屏 模式 进行 观察 。 


安装 到 Android 模 拟 器 上 ， 游 戏 项 目的 最 终 运 行 效果 如 图 13-20 所 示 。 另 外 ， 这 里 我 们 可 以 使 


至 此 ， 首 个 Cocos2d-x 项 目 已 经 完成 了 ， 我 们 对 如 何 使 用 Cocos2d-x 框 架 进行 游戏 开发 有 了 具体 的 实践 经 验 
为 我 们 提供 了 更 加 丰富 的 例子 ， 包 含 了 2D 游 戏 开发 的 方方面面 ， 实 例 代码 的 项 目 位 于 Cocos2d SDK 目 录 下 
方式 来 导入 、 创 建 并 运行 TestsDemo 项 目 ， 效 果 如 图 13-21 所 示 。 
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， 相 信 这 对 大 家 深入 学 习 Android NDK 开 发 是 很 有 益处 的 。 实 际 上 ，Cocos2d-x 的 SDK 中 还 
面 的 tests/test.android/ 目 录 中 ， 即 TestsDemo 项 目 。 我 们 可 以 仿照 之 前 创建 HelloWorld 项 目的 
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图 13-19 复制 资源 文件 
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13-20 HelloWorld (ApplicationDemo) 项 目 运行 效果 


I 566d hndreid 2.2 


ActionsTest 
TransitionsTest 
ProgressActionsTest 
EffectsTest 
ClickAndMoveTest 
RotateWorldTest 
ParticleTest 


图 13-21 TestsDemo 项 目 运行 效果 


TestsDemo 项 目 中 包含 了 2D 游 戏 开发 中 的 几乎 所 有 常用 功能 的 代码 实例 ， 包 括 了 移动 、 加 速 、 旋 转 、 层 者 、 渐 变 等 常用 效果 。 另 外 ， 还 包括 了 常见 的 游戏 引擎 ， 如 图 


展示 的 就 是 Box2D 物 理 引擎 的 使 用 实例 (菜单 名 Box2dTest) ， 在 屏幕 上 轻 按 的 时 候 ， 就 会 有 方块 从 顶部 掉 落 下 来 。 


形 引擎 、 物 理 引 警 等 。 


图 


13-22 中 


NN 5554:A&ndroid 2.2 


H13-2 ”Box2D 实 例 运行 效果 


限于 篇 幅 ， 这 里 就 不 深入 讨论 了 。 如 果 有 兴趣 ， 可 以 对 这 些 实例 的 代码 进行 深入 学 习 ， 帮 助 我 们 进一步 学 习 如 何 使 用 Cocos2d-x 框 架 开 发 Android 游 戏 。 


13.2.4 认识 Unity 3D 


Unity 3D 是 由 Unity Technologies 公 司 开发 的 一 套 能 让 你 轻松 创建 诸如 三 维 视频 游戏 、 建 筑 可 视 化 、 实 时 三 维 动画 等 类 型 互动 内 容 的 跨 平台 综合 型 游戏 开发 工具 ， 是 一 个 功能 全 面 、 强 大 的 专业 游戏 引 
Z., Unity 3D 的 出 现 ， 极 大 地 提升 了 3D 游 戏 的 开发 效率 ， 也 方便 了 跨 平台 类 型 游戏 的 开发 ， 目 前 各 大 移动 平台 (包括 Android、iOS 等 ) 上 已 经 有 非常 多 的 优秀 的 3D 游 戏 采用 了 Unity 3D 游 戏 引 擎 。 


Unity 3D 为 开发 者 提供 了 一 整套 强大 的 开发 工具 ， 让 我 们 可 以 脱离 传统 的 游戏 开发 方式 ， 以 一 种 更 简单 的 方式 专注 于 游戏 开发 。 作 为 一 个 专业 级 的 3D 开 发 软件 ，Unity 还 包含 了 价值 数 百 万 美元 的 功能 
强大 的 游戏 引擎 ， 不 管 是 开发 单机 游戏 、 网 络 游戏 或 者 是 移动 游戏 ，Unity 都 能 胜任 。 接 下 来 ， 我 们 就 来 学 习 Unity 3D 的 主要 特性 。 


1. 强 大 的 开发 工 


Unity 3D 的 开发 工具 可 以 支持 目前 几乎 所 有 的 主流 平台 ， 包 括 Windows、iOS、Android 甚 至 Xbox 等 ， 多 平台 开发 时 代 已 经 来 临 。Unity 3D 开 发 工具 的 界面 如 图 13-23 所 示 。 


2. 延 迟 泻 染 


先进 的 延迟 照明 系统 是 Unity 3D 中 最 突出 的 功能 之 一 ， 只 需要 一 点 微不足道 的 性 能 损耗 ， 我 们 就 可 以 在 场景 中 创建 几 百 个 点 光源 。 由 于 延迟 灯光 使 用 了 G 缓 冲 器 ， 因 此 Unity 3D 对 其 开放 ， 使 得 开发 者 
可 以 重新 利用 他 们 来 获取 大 量 的 其 他 高 端 图 像 效果 ， 而 没有 额外 的 性 能 损失 。 
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13-23 Unity 3D 开 发 工具 界面 


3. 光 照 贴图 


Unity 3D 提 供 了 行业 内 顶级 的 光照 贴图 技术 (Beast) 。Beast 技 术 已 经 用 于 游戏 《 镜 之 边缘 》 (Mirror's Edge) 和 《 杀 残 地 带 2》 (Killzone 2) 中 ， 通 常 每 个 Beast 授 权 都 需要 花费 10 万 美元 以 上 , 但 
集成 到 Unity 3D 中 却 是 完全 免费 的 。 使 用 Beast 光 照 贴图 可 呈现 物体 的 即时 动态 光影 互动 效果 ， 当 物体 接近 时 ，Unity 3D 会 无 颖 地 调整 光线 ， 使 阴影 和 四 凸 细节 更 加 逼真 。 


4 镜头 特效 


Unity 3D 提 升 了 游戏 后 期 特效 的 表现 ， 我 们 可 以 在 《 杀 和 珀 地 带 》 等 其 他 游戏 中 看 到 大 量 Unity 3D 专 业 处 理 后 的 特效 表现 。Unity 3D 提 供 了 光 羽 、 高 品质 景深 、 内 部 镜头 反射 、 轮 廓 线 和 深度 感知 颜色 校 
正 等 高 级 的 镜头 特效 ， 让 游戏 的 画面 效果 更 加 绚丽 。 


5 .音频 工具 


Unity 3D 为 开发 者 提供 了 强大 的 音频 采集 和 剪辑 工具 ， 即 音频 侦 听 器 (Audio Listener) 和 音频 剪辑 器 (Audio Clip) 。 配 合 场景 编辑 器 ， 开 发 者 还 可 以 方便 地 设置 音频 源 (Audio Source) 。 另 
dt, Unity 3D 还 为 所 有 的 主要 音频 参数 推出 了 可 编辑 的 衰减 曲线 ， 这 让 我 们 可 以 更 深入 地 控制 游戏 的 声音 环境 。 


6 .资源 管理 


Unity 3D 中 提供 了 内 容 管理 器 (Asset Manager) ， 支 持 以 预览 的 方式 显示 所 有 内 容 ， 开 发 者 可 以 对 资源 进行 标记 ， 以 便 在 任何 时 候 都 可 以 快速 查找 到 需要 的 资源 文件 ， 这 在 大 型 项 目的 开发 中 特别 有 


7. 代 码 调试 


Unity 3D 通 过 使 用 MonoDevelop 开 发 环境 引入 了 强大 的 脚本 调试 工具 ， 执 行 后 才能 调试 的 时 代 已 经 一 去 不 复 返 了 。 无 论 是 在 Windows 系 统 还 是 Mac 系 统 中 ， 开 发 者 都 可 以 任意 地 进行 断 点 设置 、 中 断 
游戏 、 单 步 执行 和 检查 变量 等 操作 。 


8 .遮挡 剔除 


即使 设备 具有 强大 的 硬件 ， 我 们 也 要 尽 可 能 地 提升 性 能 ， 特 别 是 对 于 移动 设备 而 言 ， 性 能 绝对 是 我 们 的 首要 关注 目标 。 遮 挡 剔 除 (Occlusion Culling) 算法 能 大 幅度 提高 山地 地 形 泻 染 效率 ， 在 Unity 
3D 中 也 整合 了 此 项 功能 。 


Unity 3D 引 警 包含 了 各 种 游戏 客户 端 制作 的 整套 方案 ， 涉 及 的 内 容 非 常 广泛 ， 已 经 远 超出 本 书 的 内 容 范畴 ， 这 里 就 不 进一步 介绍 了 ， 有 兴趣 的 读者 可 以 访问 Unity 3D 的 官方 网 站 (http://www.unity 
3d.com/) 获取 更 多 的 知识 。 
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本 章 主要 介绍 的 是 与 Android 游 戏 开发 相关 的 知识 。 首 先 ， 本 章 介 绍 了 Android 手 游 开 发 的 基本 思路 ， 即 使 用 View 和 SurfaceView 进 行 游戏 开发 的 方法 ; 然后， 结合 Android SDK 中 提供 的 两 个 游戏 实 
例 ， 即 贪 食 蛇 和 飞船 游戏 ， 讲 解 了 基本 游戏 开发 方法 的 应 用 ; 接着 ， 又 讲解 了 Android 游 戏 引擎 相关 的 基础 概念 ， 并 进一步 介绍 了 与 游戏 开发 相关 的 OpenGL、OpenGL ES 以 及 RenderScript 的 用 法 。 另 
外 ， 本 章 还 介绍 了 手 游 业界 比较 流行 的 2D 和 3D 游 戏 引擎 ， 即 Cocos2d-x 和 Unity 3D。 当 然 ， 这 些 内容 只 是 Android 游 戏 开发 相关 内 容 中 的 一 小 部 分 ， 主 要 目的 是 帮助 读者 打开 Android 游 戏 开 发 的 思路 ， 建 
议 大 家 可 以 将 其 与 Android 应 用 开发 的 思路 进行 比 对 、 体 会 ， 进 一 步 加深 对 Android 平 台 的 认识 。 


附录 A Hush Framework 框 架 实例 源码 部 署 


Hush Framework 是 本 书 重点 介绍 的 PHP 服 务 端 开源 框架 ， 该 框架 完美 地 把 PHP 官 方 框 架 Zend Framework 和 主流 模板 引擎 Smarty 结 合 起 来 ， 并 在 此 基础 上 进行 了 一 定 的 改造 和 优化 ， 框 架 的 详细 介绍 
信息 可 参考 本 书 的 3.6 节 的 相关 内 容 。 下 面 我 们 将 介绍 的 是 框架 源码 中 的 应 用 实例 的 部 署 过 程 。 


1. 源 码 下 载 


Hush Framework 开 源 项 目 已 经 被 发 布 到 GitHub 上 ， 大 家 可 以 直接 通过 Git 下 载 最 新 的 项 目 源码 ， 地 址 是 https://github.com/jameschz/hush。 建 议 大 家 使 用 Eclipse 工 具 的 EGit 插 件 进行 检 出 
(checkout) 。 假 设 我 们 把 代码 检 出 到 本 机 的 “D: \workspace\hush-framework” 目 录 下 ， 完 成 之 后 的 项 目 源码 树 如 图 A-1 所 示 ， 其 中 最 重要 的 就 是 hush-lib 类 库 的 源码 目录 ,以 及 hush-app 应 用 实例 
的 源码 目录 。 
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新 版 的 Hush Framework 已 经 包含 的 第 三 方 类 库 (如 Zend Framework, Smarty, Phpdocs$) 的 自动 安装 脚本 ， 大 家 只 需要 进入 “hush-app/bin” 目 录 下 执行 “hush sys init” 命 令 进行 自动 安装 即 
可 。 此 外 ， 本 书 的 微 博 实例 的 服务 端 部 分 就 是 使 用 Hush Framework 进 行 开 发 的 ， 而 本 书 的 源码 包 (android-php-source.zip) 里 也 已 经 包含 了 代码 范例 需要 加 载 的 所 有 库 文 件 ， 即 子 目录 phplibs 下 面 的 
代码 文件 。 


小 贴 士 : 对 于 本 机 已 经 安装 MySQL 数 据 库 的 朋友 ， 请 注意 ， 在 运行 “hush sys init” 命 令 后 的 安装 过 程 中 ， 按 照 实际 情况 输入 你 的 数据 库 地 址 、 端 口 、 用 户 名 和 密码 进行 框架 数据 库 的 安装 。 然 后 ， 再 设 


置 好 etc/database.mysql.php 中 的 数据 库 用 户 名 (_HUSH_DB_USER) 和 密码 (_HUSH_DB_PASS) ， 即 可 运行 框架 。 


2. 环 境 配置 


Hush Framework 应 用 实例 的 运行 环境 与 大 部 分 PHP 应 用 差不多 ， 为 了 便于 大 家 学 习 ， 笔 者 建议 大 家 使 用 Xampp 集 成 开发 环境 套件 ， 该 套件 包含 了 PHP 环 境 、MySQL 数 据 库 、Apache 服 务 器 等 服务 端 
组 件 ， 使 用 起 来 非常 方便 。 至 于 Xampp 开 发 环境 的 安装 和 配置 的 方法 可 参考 本 书 3.2.2 节 中 内 容 。 


运行 环境 安装 完毕 后 ， 我 们 还 需要 对 MySQL 和 Apache 进 行 配置 。 首 先 ， 配 置 MySQl 数 据 库 。 由 于 Hush Framework 默 认 的 数据 库 用 户 名 和 密码 是 root 和 passwd， 因 此 ， 我 们 需要 在 Xampp 控 制 台 的 


phpMyAdmin 工 具 中 把 数据 库 用 户 配置 好 ， 为 了 方便 开发 ， 我 们 通常 会 为 root 用 户 赋予 所 有 权限 ， 配 置 界面 如 图 A-2 所 示 。 
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然后 ， 配 置 Apache 服 务 器 。 由 于 应 用 实例 分 为 前 台 和 后 台 两 个 站 点 ， 因 此 我 们 需要 为 这 两 个 站 点 各 配置 一 个 VirtualHost 虚 拟 站 点 。 系 统 默认 的 配置 文件 httpd-vhost.conf 位 于 Xampp 根 目录 下 面 的 
apache/conf/extra 目 录 中 ， 配 置信 息 见 配置 清单 A-1。 


配置 清单 A-1 


<VirtualHost *:80> 
ServerName hush-app-backend 
DocumentRoot "D:/workspace/hush-framework/hush-app/web/backend" 
<Directory "D: /workspace/hush-framework/hush-app/web/backend"> 
AllowOverride All 
Order deny,allow 
Allow from all 
</Directory> 
</VirtualHost> 
<VirtualHost *:80> 
ServerName hush-app-frontend 
DocumentRoot "D:/workspace/hush-framework/hush-app/web/ frontend" 
<Directory "D:/workspace/hush-framework/hush-app/web/frontend"» 
AllowOverride All 
Order deny, allow 
Allow from all 
</Directory> 
</VirtualHost> 


其 中 ，DocumentRoot 指 的 是 站 点 代码 文件 所 在 的 目录 ， 大 家 可 以 根据 本 地 环境 的 实际 情况 进行 修改 ; ServerName 是 站 点 的 名 称 ， 也 是 在 浏览 器 中 输入 的 站 点 地 址 ， 前 台 和 后 台 站 点 的 默认 地 址 分 别 
是 hush-app-frontend 和 hush-app-backend。 当 然 ， 为 了 让 浏览 器 识别 以 上 站 点 地 址 ， 我 们 还 需要 修改 系统 的 hosts 文 件 。 打 开 Linux 系 统 中 的 /etc/hosts 文 件 或 者 Windows 系 统 中 的 C: 
\WINDOWS\system32\drivers\etc\hosts 文 件 ， 在 尾部 加 入 如 下 配置 即 可 。 


配置 清单 “A-2 


127.0.0.1 hush-app-frontend 
127.0.0.1 hush-app-backend 


3. 应 用 安装 


Hush Framework 应 用 实例 中 提供 了 一 系列 的 安装 脚本 ， 位 于 项 目 源码 根 目录 的 hush-app/bin 目 录 中 ， 包 含 了 Linux 和 Windows 两 个 版 本 的 可 执行 脚本 ， 即 hush 与 hush.bat， 如 图 A-3 所 示 。 
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图 A-3 


中 会 提示 初始 化 命令 将 会 执行 的 3 件 事 情 ， 即 初始 化 数据 库 、 检 查 系统 配置 以 及 清除 临时 数据 。 确 认 完 


实例 应 用 的 安装 比较 简单 ， 打 开 命 令 行 控制 台 ， 运 行 “hush sys init” 命 令 即 可 ， 此 时 命令 行 窗 
毕 后 ， 输 入 y 并 按 下 回 车 键 即 可 ， 执 行 效果 如 图 A-4 所 示 。 


此 我 们 需要 把 MySQL 命 令 行 工具 的 路 径 加 入 到 系统 的 环境 变量 Path 中 。 假 如 在 Windows 系 统 中 ， 我 们 可 以 右键 
mysql.exe 命 令 行 工具 的 所 在 路 径 加 入 到 系统 环境 变量 Path 中 ， 如 图 A-5 所 示 。 对 于 Xampp 工 具 来 说 ， 
此 ， 在 运行 初始 化 脚本 之 前 ， 需 要 先 把 Xampp 工 具 中 的 MySQL 服 务 打开 。 


这 里 需要 注意 的 是 ， 由 于 初始 化 逻辑 会 用 到 PHP 语 言 和 和 MySQL 数据 库 的 命令 行 工具 ; 
单 击 “ 我 的 电脑 ”， 找 到 “系统 属性 ”窗口 中 “高 级 ”选项 下 面 的 “环境 变量 ”按钮 ， 并 把 php.exe 和 
这 两 个 命令 行 工具 的 路 径 分 别 是 Xampp 根 目录 下 的 php 和 mysql/bin 目 录 。 另 外 ， 由 于 涉及 MySQL 数 据 库 的 初始 化 ， 因 
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在 初始 化 命令 执行 完毕 之 后 ， 如 果 出 现成 功 提示 “Thank you for using Hush Framework”,， 则 说 明 执行 成 功 了 。 当 然 ， 期 间 也 有 可 能 遇 到 失败 的 情况 ， 这 有 可 能 是 由 于 系统 环境 变量 设置 错误 或 者 
MySQL 账 号 密码 设置 错误 而 造成 的 ， 大 家 可 以 根据 错误 提示 进行 相应 的 修改 。 


最 后 ， 启 动 Xampp 的 Apache 服 务 ， 就 可 以 在 浏览 器 中 分 别 浏览 实例 应 用 的 前 后 台 站 点 了 。 前 台 站 点 地 址 为 : http://hush-app-frontend， 浏 览 效果 如 图 A-6 所 示 。 应 用 实例 的 前 台 站 点 包含 了 性 能 测 
试 、 地 址 路 由 以 及 数据 库 分 库 等 实例 ， 读 者 可 以 对 照 前 台 控制 器 类 (Controller) 的 代码 进行 学 习 。 
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Hush Framework Performance Test : 


© BES : 执行 时 间 
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Hush Url Mapping Engine Test : 
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图 A-6 


后 台 站 点 地 址 为 : http://hush-app-backend， 浏 览 效 果 如 图 A-7 所 示 。 默 认 的 超级 管理 员 用 户 名 和 密码 都 是 sa。 首 先 ， 应 用 实例 的 后 台 站 点 使 用 了 Hush Framework 的 ACL 类 库 实现 了 比较 精细 的 
RBAC 权 限 控制 策略 ， 包 含 了 角色 管理 、 用 户 管理 以 及 资源 管理 等 功能 。 另 外 ， 还 提供 了 方便 的 菜单 管理 功能 ， 以 及 工作 流 相关 的 实例 。 
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至 此 ，Hush Framework 框 架 应 


架 ， 大 家 可 以 选择 以 此 为 基础 ， 进 行 实 


微 博 应 


附录 B 


实例 的 源码 已 经 成 功 部 署 并 运行 起 来 ， 从 中 我 们 可 以 学 习 到 大 量 的 使 
示 项 目的 二 次 开发 。 想 要 获得 Hush Framework 更 详细 的 配 


说 明和 使 


PHP 进 行 实际 项 目 开发 的 实战 经 验 。 实 际 上 ， 该 应 
向 导 资 料 ， 请 参考 Hush Framework 官 网 : https://github.com/jameschz/hush, 


微 博 应 用 实例 源码 部 署 


实例 已 经 为 我 们 建立 了 一 个 基础 的 项 目 框 


实例 源码 包括 两 个 项 目 ， 即 微 博 服务 端 项 目 与 微 博 客户 端 项 目 ， 实 例 完整 源码 可 以 从 GitHub 本 书 官网 下 载 ， 地 址 为 : https://github.com/jameschz/androidphp， 源 码 包 的 文件 名 


为 “android-php-source.zip”。 解 压 后 我 们 可 以 看 到 三 个 目录 : androidphp、hush-framework 以 及 phplibs， 其 中 androidphp 目 录 包 含 了 本 书 所 有 的 实例 源码 ， 该 目录 下 的 server 和 client 目 录 中 分 别 


是 微 博 服务 端 和 微 博 客户 端 项 目 ， 而 special 和 opengl 目 录 则 分 别 是 第 11 章 中 的 Android 特 色 


发 实例 和 第 13 章 中 的 OpenGL 


下 载 微 博 应 


实例 源码 并 解压 ， 


1. 微 博 服务 端 部 署 


首先 ， 让 我 们 来 看 看 服务 端 组 件 的 配置 方法 。 微 博 应 
MySQL 服 务 器 。 不 过 ， 两 者 的 Apache 服 务 器 的 配置 却 略 有 不 同 : 微 博 服务 端 应 


把 androidphp 目 录 中 的 所 有 项 目 导 入 Eclipse 


发 工 


实例 中 MySQL 服 务 器 的 配置 参数 和 Hush Framework 实 例 完全 一 样 ， 实 际 上 ， 微 博 应 上 


免 和 其 他 站 点 冲突 ， 建 议 大 家 使 


配置 清单 B-1 


Listen 8001 
<VirtualHost *:8001> 
ServerName weibo-app-api 


80 以 外 的 端口 


DocumentRoot "D:/android-php-source/androidphp/server/www/server" 
<Directory "D:/android-php-source/androidphp/server/www/server"> 


AllowOverride All 
Order deny,allow 
Allow from all 
</Directory> 
</VirtualHost> 
Listen 8002 
<VirtualHost *:8002> 
ServerName weibo-app-web 


DocumentRoot "D: /android-php-source/androidphp/server/www/website" 
«Directory "D:/android-php-source/androidphp/server/www/website"» 


AllowOverride All 
Order deny,allow 
Allow from all 
«/Directory» 
</VirtualHost> 


以 上 配置 中 ， 大 家 可 以 根据 源码 实际 放置 的 目录 来 设置 DocumentRoot， 然 后 再 根据 ServerName 来 设置 系统 hosts 文 件 中 的 站 点 名 。 这 里 需要 注意 的 是 ， 既 然 两 个 站 点 都 已 经 分 配 了 不 同 的 端口 号 ， 
为 127.0.0.1 的 地 址 在 Android 模 拟 器 中 是 访问 不 到 的 。 


接 使 


ME 


IP 访 问 ; 另 外， 我 们 还 需要 知道 本 机 的 IP 地 址 ， 因 


门 把 微 
车 键 ,， B 


可 


然后 ， 再 来 看 看 实例 代码 的 安装 方法 。 其 实 我 们 可 以 把 微 博 实 俱 


的 服务 端 应 


代码 的 安装 。 执 行 效果 如 图 


B-1 所 示 。 


看 作 是 Hush Framework 的 另 一 个 应 
博 实 例 的 源 代码 解压 到 D 盘 , BD "D: \android-php-source”， 从 命令 行 控制 台 进入 D: \android-php-source\androidphp\server\bin 
自动 完成 微 博 服务 端 应 


包含 了 两 个 站 点 ， 即 微 博 API 站 点 (为 客户 端 提 供 API 接 
进行 设置 。 假 如 服务 端 源码 放 在 “D: \android-php-source\androidphp\server” 目 录 下 ， 那 么 httpd-vhost.conf 的 示例 如 配置 清单 B-1 所 示 。 


发 实例 的 源码 ， 部 署 方法 与 微 博客 户 端 项 


目 相同 。 


于， 我 们 就 可 以 看 到 微 博客 户 端 应 用 项 目 (app-demos-client) 和 微 博 | 
server) ， 然 后 我 们 便 可 以 在 Eclipse 中 阅读 实例 源码 了 。 为 了 更 好 地 学 习 源码 ， 大 家 还 需要 把 微 博 实例 安装 并 运行 起 来 ， 以 下 我 们 将 分 别 对 微 博 实例 服务 端 和 客 


) 和 微 


实例 ， 该 项 目的 部 署 过 程 和 Hush Framework 应 


Ex, H47 “cli sys 


实例 和 Hush Framework 实 例 完 全 可 以 使 
情 Web 站 点 (为 客户 端 提供 Web 版 接口 


及 务 端 项 目 (app-demos- 


户 端 项 目的 部 署 过 程 进 行 详细 介绍 。 


同一 个 


) 。 另 外 , ATH 


实例 的 部 署 过 程 基本 相同 。 假 如 
init" 命令， 确认 完毕 后 ， 输 入 y 并 按 


AMEE: 因为 微 博 实例 服务 端 是 基于 Hush Framewo 引 的 ， 所 以 在 安装 微 博 实例 服务 端 代码 之 前 ， 需 要 先 把 Hush Framewotk 安 装 好 。 另 外 ， 由 于 类 库 目 录 的 依赖 关系 ， 上 默认 情 况 下 androidphp 目 录 和 hush- 


framewo 红 目录 必须 是 同 级 的 ， 否 则 会 出 现 类 库 找 不 到 的 错误 。 当 然 ， 大 家 也 可 以 通过 修改 配置 文件 etc/global.defines.php 中 的 _COMM_ILIB_DIR 和 HUSH_LIB_DIR 常 量 来 指定 第 三 方 类 库 和 Hush Framework 


类 库 的 位 置 。 


* Start to initialize the Hush Framework 
MOMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMOMD 


Please pay attention to this action tt? 


Because you will do following things : 


Check or download the related 


libraries. 


Import original databases (Please make sure your current databases were alrea 
dy backuped>. 
3. Check all the runtime environment variables and directories. 


fire you sure to do all above things 


[Y/N] : 


最 后 ， 启 动 Xampp 服 务 并 打开 浏览 器 ， 就 可 以 查看 微 博 应 


服务 端的 站 点 了 ， 


B-2 所 示 的 就 是 服务 端的 接口 调试 站 点 (参考 6.1.2 节 ) ， 更 多 与 微 博 服务 端 相 关 的 内 容 可 参考 本 书 第 6 章 。 
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图 B2 


微 博客 户 端 源码 的 配置 比较 简单 ， 所 有 的 配置 参数 都 在 com.app.demos.base 包 下 的 Cjava 文 件 中 ， 我 们 可 以 很 容易 地 找到 服务 端 APIl 和 Web 站 点 的 配置 ， 如 配置 清单 B-2 所 示 。 


配置 清单 B-2 


public final class C { 
public static final class api { 
public static final String base = "http://192.168.1.2:8001"; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
} 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 
public static final class web { 
public static final String base = “http: //192.168.1.2:8002"; 
http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15327/OEBPS/Text/... 


} 


这 里 的 192.168.1.2 是 计算 机 在 局 域 网 中 的 IP 地 址 ， 大 家 需要 蔡 换 成 本 机 的 I|P 地 址 ， 若 不 知 本 机 IP， 可 以 使 用 ipconfig 命 令 查看 。 配 置 完毕 之 后 ， 就 可 以 在 Android 模 拟 器 上 运行 微 博 客户 端 应 用 了 ， 效 
果 如 图 B-3 所 示 。 
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默认 用 户 名 和 密码 都 是 james， 成 功 登录 后 就 可 进入 微 博 客户 端 中 进行 操作 。 更 多 与 微 博 客户 端 有 关 的 内 容 请 参考 本 书 第 7 章 的 内 容 。 


